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About This Manual 



This manual describes the CONTROL DATA® Network Operating System (NOS) Version 2. 
NOS 2 operates on the following computer systems: 

• CONTROL DATA CYBER 180 Computer Systems Models 810, 830, 835, 840, 845, 850, 
855, 860, 870, 960, 970, 990, 994, and 995 

• CONTROL DATA CYBER 170 Computer Systems Models 171, 172, 173, 174, 175, 176, 
720, 730, 740, 750, 760, 815, 825, 835, 845, 855, 865, and 875 

• CONTROL DATA CYBER 70 Computer Systems Models 71, 72, 73, and 74 

• CONTROL DATA 6000 Computer Systems 

Audience 

This manual assumes you are a site analyst. It assumes you are familiar with the hardware 
of your computer system(s) and that you understand the functions of the various 
components of NOS. 

Organization 

This manual includes information required for the day-to-day maintenance of the operating 
system and for troubleshooting. Topics discussed include the mass storage subsystems, 
network operations, the K and L utilities, backing up and reloading files, deadstart, and 
DIS operations. 

The appendixes include character set tables; a glossary; and descriptions of the SCOPE 2 
Station Facility, the status/control register simulator, programmable format control for 580 
printers, disk pack reformatting for 881/883 units, address formats for NOS/VE, 
management of storage media defects, and the display disk file utility. 
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Conventions 

The following conventions are used in this manual: 

examples Examples of user entries and computer responses are shown in a font 

that resembles computer output. 

lowercase In a format, lowercase letters represent values you choose. 

Numbers All numbers are decimal unless otherwise noted. 

UPPERCASE In a format, uppercase letters represent reserved words defined by the 
system for specific purposes. You must use these words exactly as 
shown. 

Vertical bar A vertical bar in the margin indicates a technical change. 

The CONTROL DATA 18002-2 console is available as an option for CYBER 180 Models 810 
and 830 Systems using NOS 2.3, PSR level 617 or later operating systems. This product 
includes a CONTROL DATA 634B display terminal (also known as the 721-21 display 
terminal) and an AV117A cable. This console is referred to throughout the manual as the 
CC634B. 

The CONTROL DATA 19003 console is available as an option for certain CYBER 180-class 
machines. This product includes a video monitor; keyboard; 40-Mbyte hard disk 
(Winchester) drive; 1.2-Mbyte, 5-1/2-in floppy disk drive; 640-Kbyte RAM memory; one 
parallel printer port; and nine RS-232-C serial ports. This console is referred to throughout 
this manual as the CC598B console. 

Models 815, 825, 835, 845, and 855 of the CYBER 170 Computer Systems share many of the 
functional and architectural attributes of the CYBER 180 Computer Systems. This manual 
uses the term CYBER 180-class machines when describing these similar models collectively. 

Extended memory for models 865 and 875 and CYBER 180-class machines is unified 
extended memory (UEM) and may also include either extended core storage (ECS), 
extended semiconductor memory (ESM), or STORNET. Extended memory for model 176 is 
large central memory extended (LCME) and may also include ECS, ESM, or STORNET. 
Extended memory for all other NOS computer systems is either ECS, ESM, or STORNET. 

In this manual, ECS refers to ECS, ESM, and STORNET; and extended memory refers to 
all forms of extended memory unless otherwise noted. However, when referencing extended 
memory in the context of a linked shared device multimainframe complex or distributive 
data path (DDP) access, UEM and LCME are excluded. ECS, ESM, and STORNET are the 
only forms of extended memory that can be shared in a linked shared device 
multimainframe complex and can be accessed by a DDP. 

(Manuals dealing with the various form of extended memory are listed under Related 
Publications.) 

In this manual, the terms tapes and magnetic tapes refer to reel magnetic tapes and 
cartridge tapes for ACS and CTS. The term MSE refers to cartridges for the 7990. The term 
cartridge alternate storage refers to alternate storage on MSE or optical disk. The term 
tape alternate storage refers to alternate storage on tapes. 
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Related Publications 

All of the following manuals are available through Control Data sales offices or through: 

Control Data 

Literature and Distribution Services AKHLDS 

4201 Lexington Avenue N. 

St. Paul, MN 55126-6198 

You can also call (612) 482-3800 or 482-3801, or FAX your inquiry to (612) 482-3813 (K you 
at aS^ol^ta employee, use the Controlnet number 235-3800, 235-3801, or 235-3813.) 

The reader should be thoroughly familiar with the material in the following NOS 

publications. 

Publication 

i — _i Number 

Manual Title _^_____ 



60459310 



NOS Version 2 Operations Handbook 

NOS Version 2 Reference Set, Volume 2, Guide to System Usage 60459670 

NOS Version 2 Reference Set, Volume 3, System Commands 60459680 

The following lists contain manuals that provide additional information about NOS and its 
product set. For the reader's convenience, these are grouped according to topic ACb 
manuals, CDCNET manuals, extended memory manuals, hardware manuals, NOb - 
manuals and optional product manuals. In addition, the NOS System Information manual 
contains brief descriptions of all NOS operating system and NOS product set manuals. It 1S 
accessed by logging into NOS and entering the EXPLAIN command. 

ACS Manuals 

The following list contains manuals that describe the CONTROL DATA 5744 Automated 
Cartridge Subsystem (ACS) software; an ACS hardware manual is listed under the 
Hardware Manuals subsection. 

Publication 
Number 



Manual Title 

5744 Automated Cartridge Subsystem, Automated Cartridge Exercise 60000517 

System, User's Guide 

5744 Automated Cartridge Subsystem, UNIX-Based Cartridge Library 60000516 

Server Workstation, Installation and Service 

5744 Automated Cartridge Subsystem, UNIX-Based Cartridge Library 60000518 

Server Workstation, Programmer's Guide 

5744 Automated Cartridge Subsystem, UNIX-Based Cartridge Library 60000519 

Server Workstation, System Administrator's Guide 

5744 Automated Cartridge Subsystem, TRANSF Client System Interface, 60000521 

Programmer's Guide 
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CDCNET Manuals 

The following list contains manuals that describe the Control Data Distributed 
Communications Network (CDCNET). 

Publication 
Manual Title Number 



CDCNET Batch Device User Guide 60463863 

CDCNET Conceptual Overview 60461540 

CDCNET Configuration Guide 60461550 

CDCNET Hardware Installation and Troubleshooting 60000348 

CDCNET Network Operations and Analysis 60461520 

CDCNET Terminal Interface Usage 60463850 

Extended Memory Manuals 

Programming information for the various forms of extended memory can be found in the 
COMPASS Version 3 Reference Manual (publication number 60492600) and in the 
appropriate computer system hardware reference manual. Hardware descriptions of the 
various forms of extended memory can be found in the following manuals. 

Publication 
Manual Title Number 



CYBER 5380-100 STORNET Subsystem (SNSS) 60000188 
Hardware Reference 

Extended Core Storage Reference Manual 60347100 

Extended Core Storage II and Distributive Data Path 60430000 
Reference Manual 

Extended Semiconductor Memory Hardware Reference Manual 60455990 
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Hardware Manuals 



The following list contains manuals that describe Control Data computer 
related equipment. 



Manual Title 



systems and 



CYBER 70 Model 71 Computer System Hardware Reference Manual 

CYBER 70 Model 72 Computer System Hardware Reference Manual 

CYBER 170 Computer Systems Models 171 through 175 
(Levels A, B, C) Model 176 (Level A, B, C) 
Hardware Reference Manual 

CYBER 170 Computer Systems Models 720, 730, 740, 750, and 760 
Model 176 (Level B/C) 
Hardware Reference Manual 

CYBER 170 Computer Systems Models 815 and 825 
Hardware Reference Manual 

CYBER 170 Computer Systems Models 835, 845, and 855 

CYBER 180 Computer Systems 

Models 835, 840, 845, 850, 855, 860, 970, and 990 

CYBER 990E, 994, and 995E Computer Systems CYBER 170 State 

Hardware Reference Manual 

CYBER 170 Computer Systems Models 835, 845, and 855 
CYBER 180 Computer Systems Models 835, 845, and 855 
Hardware Operator's Guide 

CYBER 170 Computer Systems Models 865 and 875 
Hardware Reference Manual 

CYBER 180 Models 810 and 830 Computer Systems 
Hardware Operator's Guide 

CYBER 180 Models 810 and 830 Computer Systems 
Hardware Reference Manual 

CYBER 840A, 850A, 860A, and 870A Computer Systems 

Hardware Reference Manual 

5830 Disk Array Subsystem (DAS) Configuration Guide 

5830 Disk Array Subsystem (DAS) Reference 

5831 Disk Array Subsystem (DAS) Controller Reference 

5870 Printer User's Reference Manual 

CYBER 960 Computer Systems 
CYBER 170 State 
Hardware Reference Manual 

19003 System Console CC598-A/B Operations and 
Maintenance Guide 

380-170 Network Access Device Hardware Reference Manual 
5744 Automated Cartridge Subsystem (ACS) User's Guide 



Publication 
Number 



60453300 
60347000 
60420000 

60456100 

60469350 
60469290 



60458390 

60458920 

60469440 

60469420 

60463560 

60000494 
60000552 
60000551 
60462720 
60000127 

60463610 

60458500 
60000459 
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NOS 2 Manuals 

The following list contains NOS 2 manuals. 

Manual Title 



Publication 
Number 



COMPASS Version 3 Keference Manual 

CYBER Initialization Package (CIP) Reference Manual 

CYBER Loader Version 1 Reference Manual 

CYBER Record Manager Advanced Access Methods Version 2 
Reference Manual 

CYBER Record Manager Basic Access Methods Version 1.5 
Reference Manual 

Modify Version 1 Reference Manual 

Modify Instant 

NOS Online Maintenance Software Reference Manual 

NOS Version 2 Administration Handbook 

NOS Version 2 Applications Programmer's Instant 

NOS Version 2 Diagnostic Index 

NOS Version 2 Installation Handbook 

NOS Version 2 Reference Set, Volume 1 
Introduction to Interactive Usage 

NOS Version 2 Reference Set, Volume 4 
Program Interface 

NOS Version 2 Security Administrator's Handbook 

NOS Version 2 System Overview 

NOS Version 2 Systems Programmer's Instant 



60492600 
60457180 
60429800 
60499300 

60495700 

60450100 
60450200 
60454200 
60459840 
60459360 
60459390 
60459320 
60459660 

60459690 

60460410 
60459270 
60459370 
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Optional Product Manuals 

The following list contains manuals that describe optional products. 



Manual Title 



Publication 
Number 



Binary Maintenance Log (BML) Message Formats 

COBOL Version 5 Reference Manual 

Communications Control Program Version 3 Diagnostic Handbook 

CYBER Cross System Version 1 Build Utilities Reference Manual 

CYBER Supermini Operations User's Guide 

FORTRAN Extended Version 4 Reference Manual 

FORTRAN Version 5 Reference Manual 

Message Control System Version 1 Reference Manual 

MSSI Version 3 Reference Manual 

Network Access Method Version 1/Communications Control Program Version 

3 Terminal Interfaces Reference Manual 

Network Access Method Version 1 Host Application Programming Reference 

Manual 

Network Access Method Version 1 Network Definition Language Reference 

Manual 

NOS Version 2 Full Screen Editor User's Guide 

NOS Optical Storage Subsystem QSE32835 
Reference Manual 

NOS Version 2 Screen Formatting Reference Manual 

NOS Version 2 Tape Management System (TMS) 
Site Operations Manual 

NOS Version 2 Tape Management System (TMS) 
User Reference Manual 

NOS/VE System Analyst Reference Set 
System Performance and Maintenance Manual 

Remote Batch Facility Version 1 Reference Manual 

Remote Host Facility Access Method Reference Manual 

Remote Host Facility Usage 

SCOPE Version 2.1 Operator's Guide 

TAF Version 1 Reference Manual 

TAF Version 1 User's Guide 

TAF/CRM Data Manager Version 1 Reference Manual 

Update Version 1 Reference Manual 



60459940 
60497100 
60471500 
60471200 
60459850 
60497800 
60481300 
60480300 
60458820 
60480600 

60499500 

60480000 

60460420 
60000351 

60460430 
60463350 

60463110 

60463915 

60499600 
60459990 
60460620 
60455090 
60459500 
60459520 
60459510 
60449900 
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Submitting Comments 

If you have comments concerning this manual, mail your comments to: 

Control Data 

Information Services ARH219 
4201 Lexington Avenue N. 
St. Paul, MN 55126-6198 

If you have access to SOLVER, the Control Data online facility for reporting problems, you 
can use it to submit comments about this manual. Use NS2 as the product identifier, and 
include the name and publication number of the manual. 

If you have questions about the packaging and/or distribution of printed manuals, call or 
write Literature and Distribution Services as described in Related Publications earlier in 
this preface. 

Central Software Support Hotline 

Control Data's Central Software Support maintains a hotline to assist you if you have 
trouble using our products. If you need help beyond that provided in the documentation, or 
find the product does not perform as described, call one of the following numbers and a 
support analyst will work with you. 

From the USA and Canada: 1-800-345-6628 

From other countries: 1-612-482-3434 
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Controlware Utilities 



This section describes the utilities used for loading and dumping controlware. 

Loading Controlware 

By using the LOADBC utility, you can download control module controlware, disk 
controlware, or network access device (NAD) controlware to the associated controller. 

Control Module Controlware 

You can use the LOADBC utility to load controlware into a control module for the 834 or 
836 Disk Storage Subsystem. The calling job must be of system origin or you must be 
validated for system origin privileges, and the system must be in engineering mode (refer to 
the DSD ENABLE command in section 5). LOADBC will issue appropriate messages to 
indicate the success or failure of the attempt to load controlware. 

The format of the command is: 

LOADBC, EQ=est,F=loadfile. 

Parameter Description 



EQ=est est is the EST ordinal of the control module in which to load the 

controlware. 

F=loadfile Name of the local file from which control module controlware is to be 

loaded. If F=loadfile is specified, local file loadfile must contain the 
control module controlware in binary format and an appropriate header 
(refer to the NOS Version 2 Installation Handbook). If F=loadfile is 
omitted, controlware is read from the system library SYSTEM. 
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Loading Controlware 

Disk Controlware 

You can initiate downloading of disk controlware only from the system console. Also, you 
can load the disk controlware to a channel only if it is either active or down and unassigned. 
The calling job must be of system origin or you must be validated for system origin 
privileges. The system must be in engineering mode (refer to the DSD ENABLE command 
in section 5). LOADBC will issue appropriate messages to indicate the success or failure of 
the disk controlware load attempt. 

The format of the command is: 

LOADBC, C=ch, F=loadf ile, D=dumpf ile . 

Parameter Description __^ 

C=ch ch is a 2-digit octal number of the channel to which the disk 

controlware is to be loaded. The controlware can be loaded only if the 
channel status is UP or if the channel status is DOWN and not 
assigned to a maintenance user. 

F=loadfile Name of the local file from which disk controlware is to be loaded. If 

F=loadfile is specified, local file loadfile must contain the disk 
controlware in binary format and an appropriate header (refer to the 
NOS Version 2 Installation Handbook). If F=loadfile is omitted, 
controlware is read from the system library SYSTEM. 

D=dumpfile Name of the local file to which 7155/7165/7255 disk controlware is to be 

dumped before reloading. This parameter is ignored for other types of 
controllers and an informative message is issued. LOADBC performs a 
binary comparison between the old and new controlware and writes 
this data to a file that can be processed by DSDI by using the DMB 
parameter (refer to section 6 for information on DSDI). 



Network Access Device (NAD) Controlware 

The LOADBC utility can be used to load NAD controlware into local NADs (380-170) and 
remote NADs (380-170, 380-200, 380-370, and 380-110). Since the NAD controlware is not 
automatically loaded at deadstart, LOADBC must be used before a local NAD can be used 
by the operating system. NAD controlware may be automatically loaded by the Remote 
Host Facility (RHF) when RHF is initiated. Refer to the RHF K display in section 8. 

LOADBC can be called from the console or a batch job. When loading 380-170 controlware 
into a local NAD, the EST entry associated with the NAD's channel number must be OFF or 
the controlware-not-loaded flag must be set. 

When loading a remote NAD, a local NAD that is not reserved for maintenance must be 
defined in the EST. The EST entry must be ON. Controlware must be loaded and running 
in the local NAD before loading the remote NAD. 

Remote NAD loading operations can occur concurrently with RHF use of the local NAD. 
However, extreme care should be exercised when performing a remote NAD load to ensure 
that the correct remote NAD is being loaded and that the remote NAD is not being used by 
the mainframe to which it is connected. LOADBC will issue appropriate messages to 
indicate the success or failure of the NAD controlware load attempt. 



1-2 NOS Version 2 Analysis Handbook 60459300 U 



Loading Controlware 



The format of the command is: 

LOADBC , p x , p 2 , - - • , P n • 

p. Description ■ ■ 

c=ch The 2-digit octal number of the channel to which the NAD controlware 

is to be loaded. This parameter is required. 

F=filename Name of the local file from which NAD controlware is to be loaded. If 

F=filename is specified, local file filename must contain the NAD 
controlware in binary format and an appropriate header (refer to the 
NOS Version 2 Installation Handbook). If F=filename is not specified, 
the NAD controlware type specified by the TY parameter is read from 
the system library SYSTEM. 

The following parameters apply only when loading remote NAD controlware. 
Parameter Description . 



AC=aaaa The 4-digit hexadecimal number specifying the remote NAD's access 

code (refer to the RHF K display in section 8). The default is AC=0000. 

LT^ot^t, The 4-digit binary bit pattern specifying the local trunk control units 

(TCUs) that are enabled. At least one TCU enable must be specified for 
remote NAD controlware loading. t_=l enables TCU n . For example, 
LT-1010 indicates that the local TCUs and 2 are enabled. 

ND-nn The 2-digit hexadecimal number specifying the remote NAD's address 

(refer to the RHF K display in section 8). This parameter is required 
for remote NAD loads. 

TY=value Type of controlware to be loaded. 



value Description „ — 

170 CYBER 170 controlware (380-170) 

IBM IBM controlware (380-370) 

MIN Minicomputer controlware (380-110) 

The default value is TY=170. 

Under certain conditions, a remote NAD loading operation will fail on the first attempt but 
a second loading attempt will succeed. This loading problem can be prevented by always 
preceding a remote NAD loading operation with a remote NAD dumping operation to ensure 
the remote NAD controlware is halted before loading is attempted. For example, to load a 
remote NAD with NAD address 7F and access code F0F0 connected to TCU of the local 
NAD on channel 5, enter the following commands. 

X.DMPNAD(CH=05,ND=7F,AC=FOFO,LT=1000) 
X. LOADBC (C=05,ND=7F,AC=FOFO,LT=1000) 
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Dumping Controlware 

Dumping Controlware 

The DMPCCC utility provides the capability to dynamically dump the CYBER channel 
coupler (CCC) memory in an online environment. The calling job must be of system origin 
or you must be validated for system origin privileges, and the system must be in 
engineering mode (refer to the DSD ENABLE command in section 5). 

The format of the command is: 

DMPCCC , C=ch, L=outf ile . 

Parameter Description 

C=ch ch is a 1- or 2-digit octal number of the channel from which the CCC 

memory is to be dumped. The specified channel number must be in the 
range from to 13 8 or from 20 8 to 33 8 . The default is C=0. 

L=outfile The 1- to 7-character name of the file to which the dump is to be 

written. The default is L=OUTPUT. 

DMPCCC lists the CCC memory in line format. Each line consists of 16 CCC memory words 
in hexadecimal format. Repetitive lines are suppressed. 
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Deadstart f 

Deadstart is the process that makes the system operational and ready to process jobs. After 
performing the appropriate deadstart procedures described in the CIP User's Handbook, you 
can continue the deadstart process as shown in figure 2-1 and described in detail following 
the figure. 

This section also describes what you can do to recover if you experience system problems 
during the deadstart process. 
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Figure 2-1. Deadstart Process 
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Deadstart 2-1 



Modifying the CMRDECK 



NOTE 



Modifying the deadstart decks (CMRDECK, EQPDECK, APRDECKs, and IPRDECK) does 
not apply to a level 3 recovery deadstart. Modifications made during the last level 0, 1, or 2 
deadstart are recovered during a level 3 recovery deadstart. 



Modifying the CMRDECK 

If bit 6 of word 13 (word 12 for warmstart on a CYBER 70 or 6000 Computer System with 
an active PP) is set (ppp=001), or if you select the D=Y option on the *P* display, an 
instruction display entitled CMRINST appears on the console screen(s) after the CTI 
displays on a level 0, 1, or 2 deadstart. All valid CMRDECK entries are defined in this 
display. Several of the entries listed are assigned system default values. These values are 
assumed if the entries do not appear in the CMRDECK being used. To view the contents of 
the CMRDECK being used, toggle from the CMRINST display to the CMRDECK display. If 
either the CMRDECK or CMRINST overflows two screens, the display can be paged. 

Modify the CMRDECK by entering the appropriate changes or additions from the console 
keyboard. These entries can be made while either CMRDECK or CMRINST is being 
displayed. Generally, each console entry supersedes the value currently specified in the 
CMRDECK (or default value in CMRINST). 

Refer to section 3, Deadstart Decks, for complete information on all CMRDECK entries. 

NOTE 



The modified CMRDECK remains in effect only until the next level deadstart is 
performed. Changes to the CMRDECK are not recovered for the next deadstart unless a 
new deadstart file is created. If you want these changes to take place on the next level 
deadstart, make the appropriate changes to the CMRDECK after NOS is up and running 
and use LIBEDIT to replace the record on the deadstart file. 



After all CMRDECK modifications have been made and you want to modify an EQPDECK, 
APRDECK, or IPRDECK enter: 



NEXT. 



Refer to Modifying the EQPDECK, Modifying the APRDECKs, or Modifying the IPRDECK 
in this section. Otherwise, to indicate that all modifications to the CMRDECK are complete 
and you want to begin loading the system, enter: 



GO. 
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Modifying the EQPDECK 

After completing all CMRDECK modifications, you can also modify the default EQPDECK, 
an APRDECK, or the IPRDECK being used. If no changes need to be made to any 
EQPDECK, but you do need to modify an APRDECK or the IPRDECK, refer to Modifying 
the APRDECKs or Modifying the IPRDECK later in this section. 

To modify an EQPDECK, enter 

NEXT. 

while the CMRDECK or CMRINST is being displayed. 

You can make changes when the EQPDECK, EQPINST, or any one of the deadstart displays 
is displayed at the console screen (refer to Deadstart Displays described later in this section). 

Table 2-1 describes the entries that can be made only at the console keyboard at deadstart 
time and cannot be stored in the EQPDECK on the deadstart file. Refer to section 3, 
Deadstart Decks, for complete information concerning all EQPDECK entries. 

After making the changes to EQPDECK you can toggle through the deadstart displays to 
ensure all the changes are made. 



NOTE 



The modified EQPDECK remains in effect only until the next level deadstart is 
performed. Changes to the EQPDECK are not recovered for the next deadstart unless a 
new deadstart file is created. If you want these changes to take place on the next level 
deadstart, make the appropriate changes to the EQPDECK after NOS is up and running 
and use LIBEDIT to replace the record on the deadstart file. 



After all EQPDECK modifications have been made and you want to modify an APRDECK or 
IPRDECK, enter: 



NEXT. 



Refer to Modifying the APRDECKs or Modifying the IPRDECK later in this section. 
Otherwise, to indicate that all modifications to the EQPDECK are complete and you want to 
begin loading the system, enter: 



GO. 
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Modifying the EQPDECK 



Table 2-1. EQPDECK Entries 



Entry 



Function 



AUTOLOAD. 



GRENADE. 



INrnALIZE,op,est 1 ,est 2 ,...,est n . 



Toggles the selection of buffer controller autoloading 
for all 7054/7154/7152/7155/7165/7255 control 
module controllers. This entry is valid only when 
entered from the console keyboard. That is, the 
AUTOLOAD entry cannot be included as part of the 
EQPDECK on the deadstart file. This entry, which 
affects all 7054/7154/7152/7155/7165/7255 control 
module controllers defined on the mainframe being 
deadstarted, is not necessary for normal system 
operation but is provided as an aid to hardware 
checkout. 

Toggles the selection of the grenade function. This 
entry is valid only when entered from the console 
keyboard. That is, the GRENADE entry cannot be 
included as part of the EQPDECK on the deadstart 
file. The grenade function is issued to all 
7054/7154/7152/7155/7255 control module controllers, 
once the controlware is loaded. This function causes 
unit reservations to be cleared on all 834, 836, and 
844 units physically connected to each controller. 
This entry is normally used when a unit reservation 
from a downed mainframe exists on a device. Use 
this entry with caution since it can interrupt the 
operation of another machine that could be accessing 
affected units through another controller. 

Creates new labels for the specified mass storage 
devices during a level deadstart. This entry is 
valid only when entered from the console keyboard. 
That is, the INITIALIZE entry cannot be included as 
part of the EQPDECK on the deadstart file. Before 
any mass storage device defined in the EQPDECK 
(by an EQ entry) can be used, it must have a label 
that can be recognized by the system. Existing labels 
are normally recovered automatically during all 
levels of system deadstart. However, if the existing 
label is destroyed (for example, during maintenance 
operations on the device) or if a new mass storage 
device is added to the system, you enter the 
INITIALIZE command to create a new label. 



(Continued on next page) 
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Modifying the EQPDECK 



Table 2-1. EQPDECK Entries 



Entry 



(Continued from previous page) 



Function 



Parameter Description _ 

p Level of initialization: 

AL Total initialization. 

PF Permanent files. 

QF Queued files. 

DF System dayfile. 

AF Account dayfile. 

EF Error log. 

FP Format pack (844 or 895). 

MF Binary maintenance log. 

est. The 1- to 3-digit number specified in 

the EQ entry for the device (for 
example, EQ005...). This is also the 
EST ordinal for the device. Any 
number of devices can be initialized 
with the same level of initialization, 
provided the command is no more than 
72 characters. 

Depending upon the levels of initialization selected, 
all or part of the previously existing information on 
the device is lost when the new label is created. 
Total initialization of 844 or 895 format pack (AL or 
FP options) destroys all information on a device. The 
other options selectively purge information. A 
separate INITIALIZE entry is required for each 
option selected. Selecting FP results in an automatic 
system selection of AL. The system deletes all 
existing files, including a system deadstart file, from 
a device initialized with the AL option. CTI, MSL, 
and fflVS information is not deleted when a device 
is initialized with the AL option. You cannot 
initialize the device from which you are 
deadstarting. You should initialize a device if you 
just loaded CTI, HIVS, or MSL on it. 



(Continued on next page) 
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Modifying the EQPDECK 



Table 2-1. EQPDECK Entries 



Entry 



Function 



(Continued from previous page) 



No options (except AL and FP) are processed until 
deadstart is completed. At that time, the K display 
is requested and you must enter the family name 
(FM) and device number (DN) of the device to be 
initialized. This is a final check to ensure that the 
correct device is being initialized; the selected 
options are then processed. 

If permanent files are to reside on the device being 
initialized, the EQPDECK should contain a PF entry 
for that device. The PF entry corresponds to the EST 
ordinal specified in the EQ entry and indicates that 
permanent files can reside on the device. If the 
EQPDECK displayed contains a PF entry for the 
device being initialized, a new PF entry is not 
required unless the existing entry is to be altered, or 
the associated EQ entry is altered. Redefining the 
existing EQ entry clears all associated attributes. In 
addition, if PF entries do not exist in the EQPDECK, 
initializing the device causes a default family name 
and device number to be assigned. Thus, it is 
necessary to reestablish the PF entry via the console 
keyboard if the device is to remain a permanent file 
device. For this reason, it is recommended that the 
PF entry for all mass storage devices used for 
permanent files reside in the EQPDECK Although 
this is recommended, it is not required. 

If the EQ entry in the EQPDECK displayed indicates 
that the status of a particular mass storage device is 
off when the INITIALIZE entry is made, initialize 
status is maintained and occurs automatically when 
the DSD command ON is entered for that device 
during normal system operation. 

Note that initialization of mass storage devices can 
also be accomplished during normal system 
operation via the DSD command INITIALIZE. 



(Continued on next page) 
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Modifying the EQPDECK 



Table 2-1. EQPDECK Entries 



Entry 



PRESET=est 1 ,est 2 ,-.,est n . 



Function 



(Continued from previous page) 
PRESET. 



Initializes tables (MST, TRT, MRT, DAT, BAT, BRT, 
and BDT) on the link device that are required for the 
management of shared multimainframe mass 
storage devices. The entry is valid only for level 
deadstarts by the first mainframe in the 
multimainframe complex to deadstart. This entry is 
valid only when entered from the console keyboard. 
That is, the PRESET entry cannot be included as 
part of the EQPDECK on the deadstart file. 

The amount of table space reserved on the link 
device is determined by the number of shared 
devices, as specified by the MAXSHARE entry in the 
EQPDECK If the MAXSHARE entry is not 
specified, the amount of table space reserved on the 
link device is determined by the number of shared 
device entries in the EQPDECK 

Presets independent shared devices in a 
multimainframe complex. It is valid only on a level 
deadstart by the first mainframe in the 
multimainframe complex. This entry is valid only 
when entered from the console keyboard. That is, 
the PRESET entry cannot be included as part of the 
EQPDECK on the deadstart file. 



est { 



Description 



est 



EST ordinal of independent shared device. 



RESET=est 1 ,est 2 ,...,est n . 



Rescinds all device-related attributes except those 
specified on the EQ entry. It restores the values 
specified with the last encountered EQest entry. If 
the DOWN command was specified, EQest n will be 
up, but off. Ranges of ordinals are not allowed; each 
ordinal must be entered individually. This entry is 
valid only when entered from the console keyboard. 
That is, the RESET entry cannot be included as part 
of the EQPDECK on the deadstart file. 
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Deadstart Displays 

When processing the EQPDECK, the following deadstart displays are available in addition 
to the EQPDECK and EQPINST displays. You can page through the deadstart displays in a 
circular manner. 



Display 



Description 



Equipment Status 
Mass Storage Status 

Mass Storage 
Initialization Status 

Controlware Status 

Disk Thresholds 



Shows the hardware configurations (refer to figure 2-2). 

Shows how the system allocates files on a mass storage device 
(refer to figure 2-3). 

Shows the initialization status of the devices (refer to 
figure 2-4). 

Shows the status of the controlware loaded (refer to figure 2-5). 

Shows the disk threshold values at deadstart time (refer to 
figure 2-6). 



Equipment Status Display 

The equipment status display lists the status of all the devices. 
Figure 2-2 illustrates the equipment status display. 





EQUIPMENT 


STATUS 






EST 


TYPE 


ST 


EQ 


UN 


CHANNELS 


0. 


RD 


ON 


0. 


00. 


00. 


1. 


DS 


ON 


7. 


00. 


10. 


2. 


NE 


ON 


0. 


00. 


00. 


3. 


TE 


ON 


0. 


00. 


00. 



Figure 2-2. Equipment Status Display 
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Each entry in the display appears in the following format: 

est type st eg un channels 

Header Description 



est EST ordinal. 

type Device type. The following device types can appear in the equipment 

status display. 



type Description 

AT ACS Cartridge Tape Unit; a 5680 Cartridge Tape Unit 

attached to a 5744 Automated Cartridge Subsystem (ACS). 

CC Satellite Coupler. 

CM Control module for an 834 Disk Storage Subsystem. 

CP 415 Card Punch. 

CR 405 Card Reader. 

CT CTS Cartridge Tape Unit; a standalone 5680 Cartridge 
Tape Unit. 

DB-i 885-42 Disk Storage Subsystem (1 < i < 3). 

DC-i 895 Disk Storage Subsystem (1 < i < 2). 

DD-i 834 Disk Storage Subsystem (1 < i < 8). 

DE Extended memory. 

DF-i 887 Disk Storage Subsystem (4K sector; 1 < i < 3). 

DG-i 836 Disk Storage Subsystem (1 < i < 3). 

DH-i 887 Disk Storage Subsystem (16K sector; 1 < i < 2). 

Dl-i 844-21 Disk Storage Subsystem (1 < i < 8; half track). 

DJ-i 844-41/44 Disk Storage Subsystem (1 < i < 8; half track). 

DK-i 844-21 Disk Storage Subsystem (1 < i < 8; full track). 

DL-i 844-41/44 Disk Storage Subsystem (1 < i < 8; full track). 

DM-i 885-11/12 Disk Storage Subsystem (1 < i < 3; half track). 

DN 9853 Disk Storage Subsystem. 

DP Distributive data path to extended memory. 

DQ-i 885-11/12 Disk Storage Subsystem (1 < i < 3; full track). 
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Header Description 



type (Continued) 

type Description 



DV 819 Disk Storage Subsystem (single density). 

DW 819 Disk Storage Subsystem (double density). 

EA-i 5830 Disk Array Subsystem; one 5832 SSD drive run in 

serial mode (1 < i < 8). 

EB-i 5830 Disk Array Subsystem; two 5832 SSD drives run in 

parallel mode (1 < i < 6). 

EC-i 5830 Disk Array Subsystem; one 5833 Sabre drive run in 

serial mode (1 < i < 2). 

ED-i 5830 Disk Array Subsystem; two 5833 Sabre drives: one for 

data and the other for parity (1 < i < 2). 

EE 5830 Disk Array Subsystem; two 5833 Sabre drives run in 

parallel mode. 

EF 5830 Disk Array Subsystem; three 5833 Sabre drives: two 

for data and one for parity. 

EG 5830 Disk Array Subsystem; one 5838 Elite drive. 

EH 5830 Disk Array Subsystem; two 5838 Elite drives: one for 

data and one for parity. 

LQ Any line printer. 

LR 580-12 Line Printer. 

LS 580-16 Line Printer. 

LT 580-20 Line Printer. 

LX 5870 Printer. 

MT Magnetic Tape Drive (7 track). 

NC 380-170 Network Access Device. 

ND CDCNET Device Interface (MDI or MTI). 

NP 255x Network Processing Unit. 

NT Magnetic Tape Drive (9 track). 

OD Optical Disk Drive. 

RM Two-port multiplexer (models 865, 875, and CYBER 
180-class machines). 

SS MSE Controller. 

TT Internal stimulation device. 
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Header Description 



type (Continued) 

The system creates the following device types at deadstart for internal 
use. Except for the display console, DS, physical hardware does not 
exist for these device types. The device types appear in the second 
column of the equipment status display along with the real device 
types. 



type Description 



DS Display console (EST ordinal 1). 

NE Null equipment (EST ordinal 2). 

RD Used for online reconfiguration of mass storage (EST 

ordinal 0). 

TE Tape equipment (EST ordinal 3). 

TT Used for assignment of terminal files (EST ordinal 4). 

st Equipment status (ON, OFF, IDLE, or DOWN). 

eq Equipment number that corresponds to switch settings on the 

controller that connects the equipment to the channel(s). The site 
engineer is responsible for setting these switches. Ask your customer 
engineer for the correct switch settings if you are unsure. 

un Unit number (serves as ID code for unit record devices). The ID code 

provides a method of grouping unit record devices when a site has 
several units. Output from a job read in through a card reader with 
identifier un can only be directed to a device with the same identifier. 
Changing the identifier code via the ROUTE command can direct 
program output to a special printer. 

Most equipment has the unit number labeled on the equipment. Some 
equipment has the unit number as part of a switch or button. Ask your 
customer engineer for the correct unit numbers if you are unsure. 

channels Channel(s) on which equipment is available. An asterisk (*) instead of 

a period (.) following the channel number entry indicates that the 
channel is down. 
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Mass Storage Status Display 

The mass storage status display provides detailed information about all mass storage 
devices. 

Figure 2-3 illustrates the mass storage status display. 

MASS STORAGE STATUS 

EST TYPE STATUS FILES 

5. DE AI S 

6. DB S 1 B— R— T 

7. DB S 1 R--T 

10. DB S 1 R — T 

11. DB S 1 R--T 

14. DQ 

15. DQ 

16. DQ 

17. DQ F- 

20. DQ 

21. DQ 

22. DL --R 

23. DL --R 

24. DL --R 

25. DL --R 



Figure 2-3. Mass Storage Status Display 
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Each entry in the display appears in the following format: 

est type status files 

Header Description 

est EST ordinal, 

type Device type: 



type Description 

DB-i 885-42 Disk Storage Subsystem (1 < i < 3). 

DC-i 895 Disk Storage Subsystem (1 < i < 2). 

DD-i 834 Disk Storage Subsystem (1 < i < 8). 

DE Extended memory. 

DF-i 887 Disk Storage Subsystem (4K sector; 1 < i < 3). 

DG-i 836 Disk Storage Subsystem (1 < i < 3). 

DH-i 887 Disk Storage Subsystem (16K sector; 1 < i < 2). 

Dl-i 844-21 Disk Storage Subsystem (1 < i < 8; half track). 

DJ-i 844-41/44 Disk Storage Subsystem (1 < i < 8; half track). 

DK-i 844-21 Disk Storage Subsystem (1 < i < 8; full track). 

DL-i 844-41/44 Disk Storage Subsystem (1 < i < 8; full track). 

DM-i 885-11/12 Disk Storage Subsystem (1 < i < 3; half track). 

DN 9853 Disk Storage Subsystem. 

DP Distributive data path to extended memory. 

DQ-i 885-11/12 Disk Storage Subsystem (1 < i < 3; full track). 

DV 819 Disk Storage Subsystem (single density). 

DW 819 Disk Storage Subsystem (double density). 

EA-i 5830 Disk Array Subsystem; one 5832 SSD drive run in 

serial mode (1 < i < 8). 

EB-i 5830 Disk Array Subsystem; two 5832 SSD drives run in 

parallel mode (1 < i < 6). 
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Header 



Description 



type 
(Continued) 



status 



Device type. 



type 



Description 



EC-i 5830 Disk Array Subsystem; one 5833 Sabre drive run in 

serial mode (1 < i < 2). 

ED-i 5830 Disk Array Subsystem; two 5833 Sabre drives: one for 

data and the other for parity (1 < i < 2). 

EE 5830 Disk Array Subsystem; two 5833 Sabre drives run in 

parallel mode. 

EF 5830 Disk Array Subsystem; three 5833 Sabre drives: two 

for data and one for parity. 

EG 5830 Disk Array Subsystem; one 5838 Elite drive. 

EH 5830 Disk Array Subsystem; two 5838 Elite drives: one for 

data and one for parity. 

Status conditions. Any combination of conditions can exist. The 
following codes are listed in the order in which they appear on the 
display. 

status Description 

S 

M 

R 

N 

A 

I 

P 

D 

C 

E 

B 

F 

G 



A copy of the system resides on this device. 

Device is shared by more than one mainframe. 

Device is removable. 

Independent shared device. 

Alternate system device. 

Initialization requested or format is pending. 

Preset of the device requested. 

System dayfile on this device. 

Account dayfile on this device. 

Error log on this device. 

Binary maintenance log on this device. 

System default family on this device. 

Checkpoint device. A copy of the checkpoint file resides on 
this device. 
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Header Description 



files Types of files that are allowed on this device. Any combination of types 

can exist. The following codes are listed in the order in which they 
appear on the display. Refer to the MSAL EQPDECK entry in section 
3, Deadstart Decks. 



status 


Description 


S 


Secondary rollout. 


B 


LGO. 


L 


Local. 


P 


Primary. 


D 


Job dayfile. 


R 


Rollout. 


O 


Output. 


I 


Input. 


T 


Temporary. 
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Mass Storage Initialization Status Display 



The mass storage initialization status display shows the initialization status of mass 
storage devices on the system. 

Figure 2-4 illustrates the mass storage initialization status display. 



MASS STORAGE INITIALIZATION STATUS 

EST TY OPTIONS T IAM DAM FM/PN DN NC 

— QSA— 

E- 

--PQSAED 
FT 

F 377. 377. FEATURE 40. 000. 

X 000. 377. R4IAE 000. 



5. 


DE 


6. 


DB 


7. 


DB 


10. 


DB 


11. 


DB 


14. 


DQ 


15. 


DQ 


16. 


DQ 


17. 


DQ 


20. 


DQ 


21. 


DQ 



Figure 2-4. Mass Storage Initialization Status Display 

Each line in the display appears in this format: 

est type options t iam dam fm/pn dn 

Header Description 

est EST ordinal, 

type Device type. 

type Description 



DB-i 885-42 Disk Storage Subsystem (1 < i < 3). 

DC-i 895 Disk Storage Subsystem (1 < i < 2). 

DD-i 834 Disk Storage Subsystem (1 < i < 8). 

DE Extended memory. 

DF-i 887 Disk Storage Subsystem (4K sector; 1 < i < 3). 

DG-i 836 Disk Storage Subsystem (1 < i < 3). 

DH-i 887 Disk Storage Subsystem (16K sector; 1 < i < 2). 

Dl-i 844-21 Disk Storage Subsystem (1 < i < 8; halftrack). 
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Header 



Description 



type 



options 



(Continued) 
type 



DJ-i 

DK-i 

DL-i 

DM-i 

DN 

DP 

DQ-i 

DV 

DW 

EA-i 

EB-i 

EC-i 

ED-i 

EE 

EF 

EG 
EH 



Description 



844-41/44 Disk Storage Subsystem (1 < i < 8; halftrack). 

844-21 Disk Storage Subsystem (1 < i < 8; full track). 

844-41/44 Disk Storage Subsystem (1 < i < 8; full track). 

885-11/12 Disk Storage Subsystem (1 < i < 3; halftrack). 

9853 Disk Storage Subsystem. 

Distributive data path to extended memory. 

885-11/12 Disk Storage Subsystem (1 < i < 3; full track). 

819 Disk Storage Subsystem (single density). 

819 Disk Storage Subsystem (double density). 

5830 Disk Array Subsystem; one 5832 SSD drive run in 

serial mode (1 < i < 8). 

5830 Disk Array Subsystem; two 5832 SSD drives run in 

parallel mode (1 < i < 6). 

5830 Disk Array Subsystem; one 5833 Sabre drive run in 
serial mode (1 < i < 2). 

5830 Disk Array Subsystem; two 5833 Sabre drives: one for 
data and the other for parity (1 < i < 2). 

5830 Disk Array Subsystem; two 5833 Sabre drives run in 
parallel mode. 

5830 Disk Array Subsystem; three 5833 Sabre drives: two 
for data and one for parity. 

5830 Disk Array Subsystem; one 5838 Elite drive. 

5830 Disk Array Subsystem; two 5838 Elite drives: one for 

data and one for parity. 



Initialize options. Maximum of eight options are displayed. 
options Description 



F 
T 
P 

Q 

S 
A 
E 
B 



Format pack. 
Total system. 
Permanent files. 
Queue files. 
System dayfile. 
Account dayfile. 
Error log. 
Binary maintenance log. 
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Header Description 



Type of unit device. 

t Description 



F Family device. 

X Auxiliary device. 

iam Indirect access mask, 
dam Direct access mask, 
fm/pn Family name/pack name. 
fm/pn Description 



F Family name. 

X Pack name. 

dn Device number if the device unit is the family device, 

nc Number of permanent file catalog tracks. 

Controlware Status Display 

The controlware status display shows what type of controlware is loaded to which channels. 
Figure 2-5 illustrates the controlware status display. 



CONTROLWARE STATUS 
CHANNEL CONTROLWARE 

00. 

01. 

02. 

03. NN 

04. 

05. 

07. FM 

10. 

11. NN 

12. 

13. 



Figure 2-5. Controlware Status Display 

Each line in the display appears in this format: 

channel controlware 

Header Description 



channel Channel on which equipment is available. 

controlware Name of the controlware loaded. Eefer to the LBC EQPDECK entry in 

section 3, Deadstart Decks, for a list of controlware types. 
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Disk Thresholds Display 

The disk thresholds display shows the disk threshold values at deadstart time. The system 
uses these threshold values as limits when monitoring disk verification failures, available 
disk space, and disk error processing. If a threshold value is exceeded, the system performs 
a corrective action, such as notifying the operator or restricting activity on the affected disk. 

Figure 2-6 illustrates the disk thresholds display. 



EST TYPE SIZE VF RA LS RE UE 
6 DL-3 3150 100 315 146 100 



Figure 2-6. Disk Thresholds Display 

Each line in the display appears in the following format: 

est type size vf ra Is re ue 

Header D escription 

est EST ordinal, 

type Device type. 



type Description 



DB-i 885-42 Disk Storage Subsystem (1 < i < 3). 

DC-i 895 Disk Storage Subsystem (1 < i < 2). 

DD-i 834 Disk Storage Subsystem (1 < i < 8). 

DE Extended memory. 

DF-i 887 Disk Storage Subsystem (4K sector; 1 < i < 3). 

DG-i 836 Disk Storage Subsystem (1 < i < 3). 

DH-i 887 Disk Storage Subsystem (16K sector; 1 < i < 2). 

Dl-i 844-21 Disk Storage Subsystem (1 < i < 8; half track). 

DJ-i 844-41/44 Disk Storage Subsystem (1 < i < 8; halftrack). 

DK-i 844-21 Disk Storage Subsystem (1 < i < 8; full track). 
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Header Description 



type (Continued) 

type Description 



DL-i 844-41/44 Disk Storage Subsystem (1 < i < 8; full track). 

DM-i 885-11/12 Disk Storage Subsystem (1 < i < 3; halftrack). 

DN 9853 Disk Storage Subsystem. 

DP Distributive data path to extended memory. 

DQ-i 885-11/12 Disk Storage Subsystem (1 < i < 3; full track). 

DV 819 Disk Storage Subsystem (single density). 

DW 819 Disk Storage Subsystem (double density). 

EA-i 5830 Disk Array Subsystem; one 5832 SSD drive run in 

serial mode (1 < i < 8). 

EB-i 5830 Disk Array Subsystem; two 5832 SSD drives run in 

parallel mode (1 < i < 6). 

EC-i 5830 Disk Array Subsystem; one 5833 Sabre drive run in 

serial mode (1 < i < 2). 

ED-i 5830 Disk Array Subsystem; two 5833 Sabre drives: one for 

data and the other for parity (1 < i < 2). 

EE 5830 Disk Array Subsystem; two 5833 Sabre drives run in 

parallel mode. 

EF 5830 Disk Array Subsystem; three 5833 Sabre drives: two 

for data and one for parity. 

EG 5830 Disk Array Subsystem; one 5838 Elite drive. 

EH 5830 Disk Array Subsystem; two 5838 Elite drives: one for 

data and one for parity. 

size Total number of logical tracks on the corresponding device type. 

vf Verification failure threshold. 

ra Restricted activity threshold. 

Is Low space threshold. 

re Recovered error threshold. 

ue Unrecovered error threshold. 
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Modifying the APRDECKs 

After completing all EQPDECK modifications, you can also modify the default APRDECK 
the APRDECK for a specific equipment, or the IPRDECK being used. You can modify an 
APRDECK only when you are initializing the corresponding equipment. If no changes need 
to be made to any APRDECK, but you do need to modify the IPRDECK, refer to Modifying 
the IPRDECK later in this section. 

The APRDECK contains entries identifying areas of mass storage that are not usable 
(flaws). The APRDECK used can vary from equipment to equipment. One of the parameters 
specified when an equipment is defined in the EQPDECK is the APRDECK number that 
applies to that equipment. The default (APRDOO) is selected if this parameter is not 
specified. 

To modify an APRDECK enter 

NEXT. 

while the EQPDECK or EQPINST is being displayed. The APRINST display describes the 
valid entries. You can toggle between the APRDECK and APRINST. Enter the changes or 
additions to the APRDECK from the console keyboard (refer to section 3, Deadstart Decks, 
for a description of the entries). 

If there are no changes to the APRDECK displayed, enter 

NEXT. 

to go to the next APRDECK Repeat this process until the appropriate APRDECK is 
displayed or until you have changed all APRDECKs needing changes. 

After all APRDECK modifications are complete, you can skip to the IPRDECK by entering: 

IPR. 

Refer to Modifying the IPRDECK next, for more information. Otherwise, to indicate that 
all modifications to the APRDECKs are complete and you want to begin loading the system, 
enter: 

GO. 
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Modifying the IPRDECK 

The IPRDECK contains installation parameters that describe the mode of system operation. 
IPRDECK modification is seldom required during deadstart since nearly all IPRDECK 
commands are also valid DSD commands that make the same changes during normal 
system operation. Generally, installation parameters changed during normal operations 
(with DSD commands or by modifying the IPRDECK) are retained only across a level 3 
recovery deadstart. 

After entering 

IPR. 

when all the CMRDECK, EQPDECK, or APRDECK modifications are complete or after 
repeatedly entering 

NEXT. 

to step through all the APRDECKs, the instruction display entitled IPRINST appears on 
the console screen(s). This display defines all valid IPRDECK entries. Most of these entries 
are also valid DSD commands. 

To view the contents of the IPRDECK being used, toggle from the IPRINST display to the 
IPRDECK display. If either the IPRDECK or IPRINST overflows two screens, you can page 
the display. 

Enter the appropriate changes or additions from the console keyboard. These entries can be 
made while either IPRINST or IPRDECK is being displayed. A console entry supersedes the 
value currently specified in the IPRDECK 

NOTE 

The modified IPRDECK remains in effect only until the next level 0, 1, or 2 deadstart is 
performed. Changes to the IPRDECK are retained if a level 3 recovery deadstart is 
performed. If you want these changes to take place on the next level deadstart, make the 
appropriate changes to the IPRDECK after NOS is up and running and use LIBEDIT to 
replace the record on the deadstart file. 

For complete information concerning IPRDECK entries, refer to section 3, Deadstart Decks, 
and to section 5, DSD Commands. 

To indicate that changes to the CMRDECK, EQPDECK, APRDECK and/or IPRDECK are 
completed and you want to begin loading the system, enter: 

GO. 
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Loading the System 

If you are performing a level or level 2 deadstart, the system library is automatically 
loaded from the deadstart file to each mass storage device specified in the EQPDECK as a 
system device. If no system device is specified, the system is loaded on the first 
nonremovable mass storage device in the equipment status table. 

Mass storage labels are validated for all levels of deadstart. This ensures that the 
configuration matches the one specified in the EQPDECK Normally, the device label 
validation display appears for only a few seconds. However, this display remains longer 
(from 30 seconds to 3 minutes) if 834, 836, 887, or 9853 disk units must first be 
automatically spun up in order to validate their labels. 

If you specify a level 1 or level 3 recovery deadstart, the system library is not reloaded. In 
this case, the deadstart file is rewound and is not accessed again until another deadstart 
operation is performed. The system library is recovered from checkpoint information on 
mass storage. Central memory tables such as the system file name table (FNT), executing 
job table (EJT), queued file table (QFT), equipment status table (EST), and track reservation 
table (TRT) are either recovered from checkpoint information for level 1 or from central 
memory (and the link device, extended memory, if in multimainframe mode) for level 3. 

Messages 

If a deadstart error occurs, a message appears on the right console screen and, depending 
upon the nature of the error, deadstart processing may halt. Refer to Error Processing later 
in this section for complete information and corrective action. If the system is being loaded 
(level or 2 only), the name of each system library program is also displayed on the right 
console screen as it is being loaded. This allows you to monitor deadstart progress. 

The left console screen may display the message ENTER DATE YY/MM/DD. You can enter 
the date while the system is being loaded. 
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Entering the Date and Time 

Each time a system deadstart function is performed, it is necessary to enter the current 
date and time (except for CYBER 180-class machines; they get the date and time from CTI 
during deadstart). The system uses the date and time (updated every second) for dayfile 
messages and for permanent file catalogs and directories for files being accessed. This 
includes the creation, last modification, and last access date and time for each permanent 
file in the system. It is important to enter the correct date and time in order to accurately 
maintain these system records. If you are performing a level 3 recovery deadstart, it is 
possible to recover the date and time from the previous system deadstart. However, this is 
not recommended since the new date and time recorded for system records would no longer 
be accurate. 

When the system loading (or recovery) phase of deadstart is about to begin, the system 
checks for the correct date and time. If CTI is unable to determine the correct date and time 
or the mainframe is other than a CYBER 180-class, the following message appears on the 
left console screen requesting entry of the current date. 

ENTER DATE YY/MM/DD. 

Enter the current date, followed by CR, in this format: 

yy/mm/dd. 

Entry Description 

yy Year; 70 through 99 (corresponds to the years 1970 through 1999) or 00 

through 33 (corresponds to the years 2000 through 2033). 

mm Month; 01 through 12. 

dd Day; 01 through nn (nn is the number of days in the month). 

For deadstart levels 0, 1, and 2, pressing CR without first entering the date causes the 
system to assume the date that the deadstart file was created. For a level 3 recovery 
deadstart, pressing CR alone recovers both the previous date and time (time entered during 
the last deadstart plus time accumulated until this deadstart). 

When the system accepts the date entry, it displays the following request for entry of the 
current time. 

ENTER TIME HH.MM.SS. 

Enter the current time in this format: 

hh.mm.ss. 

Entry Description 

hh Hour; 00 through 23. 

mm Minute; 00 through 59. 

ss Second; 00 through 59. 

For deadstart levels 0, 1, and 2, pressing CR without first entering the time causes the 
system to set the time to 00.00.00. If you enter CR alone following the date prompt on a 
level 3 recovery, this prompt to enter time does not appear (the previous time is assumed). 
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Initiating Job Processing 

DSD commands specified in the IPRDECK automatically initiate normal job processing 
except on a level 3 recovery where you must enter AUTO. If a level 1 or level 3 recovery 
deadstart is being performed, the system recovers all jobs and active files and resumes 
normal operation immediately. However, if an initial deadstart (level 0) or level 2 recovery 
deadstart is being performed, job processing may not be initiated immediately. The time of 
initiation depends upon the time it takes to load the system from the deadstart file (you can 
monitor progress on the right console screen). If file loading is not completed when the time 
entry is made, the DSD commands specified in the IPRDECK are displayed on the left 
screen. Until file loading completes, you can clear one or more of the DSD commands. 

Clearing a command prevents it from being executed when file loading completes. In this 
case, you must manually enter the commands necessary to initiate job processing from the 
console keyboard. 

To initiate job processing, enter: 

AUTO . 

or 

MAINTENANCE . 

or 

SCHEDULE. 

Following entry of the AUTO, MAINTENANCE, or SCHEDULE command during an initial 
(level 0) deadstart, the deadstart sequencing process begins. Deadstart sequencing causes 
job processing to be suspended until all system files in the default family are initiated. To 
initiate a family other than the default, enter the command: 

X.ISF(FM=£amily) 
Parameter Description 



family Alternate family of devices. 

For additional information concerning the ISF command and deadstart sequencing, refer to 
section 20, System File Initialization. 
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Normal job processing begins after the deadstart sequencing job completes. If the AUTO 
command is entered, the subsystems enabled in the IPRDECK are automatically assigned 
to specified control points. Assuming that all standard subsystems are set to be enabled, the 
system calls them to specific control points as shown in the following example: 



Control Point 
Number 


Job Sequence 
Name 


Activity 


1 


IAF 


Interactive Facility. 


2 


NAM 


Network Access Method. 


3 


RHF 


Remote Host Facility. 


4 


SMF 


Screen Management Facility. 


n-2 1 


MAG 


Magnetic tape subsystem executive routine. 


n-1* 


BIO 


Central site batch input/output. 


n 1 


RBF 


Remote Batch Facility. 


n+1 1 


SYS 


System. 



The MAINTENANCE command performs the same function as the AUTO command. 
Additionally, it assigns several maintenance routines, according to mainframe type, to 
available control points and runs them as normal jobs with minimum queue and CPU 
priorities. These are CPU or central memory test routines designed to detect hardware 
errors. The routines display error messages either at the control point on the B,0 display or 
in the system error log. To display the error log, enter: 

A, ERROR LOG. 

You should monitor these routines from time to time. If a maintenance routine displays an 
error message indicating a hardware malfunction occurred, call a customer engineer. It is 
recommended that these programs be run at all times. The maintenance programs use little 
memory, are run at minimum CPU and queue priority, and are automatically rolled out if 
necessary; thus, system performance is not severely affected. Descriptions of the 
maintenance routines are in the NOS Online Maintenance Software Reference Manual. 

You can use the SCHEDULE command to schedule jobs, but it does not initiate subsystems 
or maintenance jobs. Refer to the NOS Version 2 Operations Handbook for a description of 
the SCHEDULE command. 



1. n is the number of control points denned by the NCP entry in the CMRDECK. 
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Preparing for Recovery Deadstart 

Sometimes during system operation an uncorrectable error occurs that prevents further 
system activity. Often the situation can be corrected by deadstarting the system and 
recovering prior activity. The success of such a recovery depends upon the severity of the 
problem and the extent to which system information is destroyed. There are three levels of 
recovery deadstart available (levels 1, 2, and 3). Table 2-2 lists each deadstart level, 
including level (initial deadstart), and describes the extent of recovery possible. 

If the MS VALIDATION installation option is enabled during a level 1 or 2 recovery, or if 
both the MS VALIDATION and PF VALIDATION options are enabled during a level 3 
recovery, the system: 

• Verifies selected mass storage files. 

• Checks files identified in the queued file table (QFT) to ensure that all tracks in the 
chain are reserved and that no circular linkage exists. 

• Depending on file type, checks the track reservation table (TRT) to ensure that the file 
is preserved. 

• Checks all preserved files for proper length. 

If the system encounters a verification failure, it clears the queued file table entry but does 
not release disk space assigned to the file. If a length error is detected, the system sets 
error idle status and terminates recovery operations on the device. To recover from an error 
idle condition, refer to Error Idle Recovery under Error Processing later in this section. 

During level deadstart, the system verifies the length of preserved files regardless of the 
setting of the MS VALIDATION option. If a length error is detected, the system reads the 
disk chain to determine the correct length of the file, issues a message to the B,0 display, 
and stops recovery of the device. To alter the EOI for the file and proceed with recovery, 
enter: 

GO , SYS . or GO , . 

To terminate recovery of the device, enter: 

PAUSE, SYS. 
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Table 2-2. Levels of System Deadstart: Information Recovered 



Dead- 
start 
Level 


Jobs 


Queued Files 


Perma- 
nent 
Files 


System 


System 
Dayfiles 





Batch jobs are 
rerun. 1 


Recovered as 
inactive. 


Yes. 


No. 


Yes. 2 


1 


Recovered from 
last checkpoint. 


Active queues 
recovered from last 
checkpoint. 


Yes. 


Recovered 
from last 
checkpoint. 


Yes. 


2 


Recovered from 
last checkpoint. 


Active queues 
recovered from last 
checkpoint 


Yes. 


No. 


Yes. 


3 


Recovered from 
CMcopyofEJT. 3 


Active queues 
recovered from CM 
copyofQFT. 


Yes. 


Yes. 


Yes. 



1. The input and output queues are recovered. Rolled out and executing batch jobs are 
also rerun. The input files associated with these jobs are returned to the input queues, 
unless the device they reside on is initialized. Permanent files are recovered unless the 
device is initialized. 

2. Dayfiles are recovered unless initialized by an INITIALIZE entry in the EQPDECK 

3. Jobs that are rolled out continue. Jobs that are in CM are aborted with EXIT 
processing and then rerun if possible. 
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CAUTION 



Before attempting any level of recovery deadstart, whether it is a level 0, 1, 2, or 3 
deadstart, enter a CHECKPOINT SYSTEM command, and wait for the CHECKPOINT 
COMPLETE message to appear on the system console. The CHECKPOINT SYSTEM 
performs the following functions: 

1. All currently executing jobs are rolled out. (Ensures that these jobs can roll back and 
continue executing after a level 3 deadstart.) 

2. All mass storage tables and track reservation tables are copied to disk, and all pending 
disk I/O operations are completed. (Ensures the integrity of the disks after a level 0, 1, 
or 2 deadstart.) 

3. A system checkpoint file (which includes a copy of all the system tables in central 
memory) is written to disk. (Provides a system checkpoint file for a level 1 or 2 
deadstart.) 

If, due to a system hang or other problem, it is not possible to enter a CHECKPOINT 
SYSTEM, or if the CHECKPOINT COMPLETE message does not appear, the disk updates 
may not have been performed. If a level deadstart is performed at this time, permanent 
file information may be lost. To prevent such a loss, always perform a level 3 deadstart after 
a system hang. Select the ABORT option on the level 3 deadstart display to abandon the 
deadstart; the ABORT option performs the disk updates and then abandons the deadstart. 

The following topics provide general information concerning each level of system deadstart 
and recommended steps of preparation. 
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Level 3 Recovery Deadstart 

Usually you perform a level 3 recovery deadstart following an equipment or system 
malfunction (for example, channel or PP hung), providing the system remains intact. 
Basically, the system FNT, QFT, EJT, TRT, EST, and control-point areas of central memory 
must be intact in order to successfully perform a level 3 recovery deadstart. However, 
unless you can determine that central memory is no longer intact, attempt a level 3 recovery 
deadstart before a level deadstart. This is recommended because system activity, as it 
existed at the time of the malfunction, can best be recovered by performing a level 3 recovery 
deadstart. Only PP memory confidence testing occurs during a level 3 recovery deadstart; 
central memory is not affected. User jobs running at control points are either rerun or 
aborted by a level 3 deadstart; rolled out user jobs are rolled back in and continue to run. 

Requests for device checkpoint are retained over a level 3 recovery. Therefore, if a system 
malfunction prevents a device checkpoint from being done, the checkpoint is processed after 
level 3 recovery is successfully completed. If a level 3 recovery fails, always do another level 
3 recovery with the ABORT option selected before doing a level deadstart. This ensures 
that all checkpoint processing is done correctly. 

On a level 3 deadstart the CMRDECK, the EQPDECK, the APRDECKs, and the IPRDECK 
cannot be viewed or changed. The CMRDECK, the EQPDECK, the APRDECKs, and the 
IPRDECK specified during the last level deadstart remain in effect. If you set the 
CMRDECK switch (bit 6 in word 13 of the deadstart panel) or select the D=YES option on 
the CTI *P* display; the system halts and displays level 3 deadstart options. The options 
and their default values are displayed on the left screen (figure 2-7) and instructions on the 
right screen (figure 2-8). 



LEVEL 3 OPTIONS 

ABORT . NO 

ABORT, B. NO 

AUTOLOAD. YES 

GRENADE . NO 

AUTO. YES 



Figure 2-7. Level 3 Deadstart Left Screen Display 
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INSTRUCTIONS FOR SELECTING LEVEL 3 RECOVERY OPTIONS. 

ENTER COMMAND TO TOGGLE SELECTION. 

ENTER GO. TO CONTINUE RECOVERY. 
ABORT. 

CHECKPOINT ALL DEVICES AND ABORT LEVEL 3 RECOVERY. 

SELECTING * ABORT.* DESELECTS *ABORT,B.* 

ABORT, B. 

CHECKPOINT ALL NONBUFFERED DEVICES AND ABORT LEVEL 
3 RECOVERY. SELECTING *ABORT,B.* DESELECTS *ABORT.*. 

AUTOLOAD. 

TOGGLE THE SELECTION OF BUFFER CONTROLLER AUTOLOADING. 

GRENADE. 

TOGGLE THE SELECTION OF THE GRENADE FUNCTION. THE 
GRENADE FUNCTION IS ISSUED ONCE THE CONTROLWARE IS 
LOADED, CAUSING UNIT RESERVATIONS TO BE CLEARED ON 
ALL 844 UNITS PHYSICALLY CONNECTED TO EACH CONTROLLER. 

AUTO. 

TOGGLE THE SELECTION OF THE DSD AUTO COMMAND. 



Figure 2-8. Level 3 Deadstart Right Screen Display 

Entering a command will toggle the level 3 deadstart selections. The ABORT command 
checkpoints all the devices and aborts level 3 recovery. Selecting the ABORT command 
automatically deselects the ABORT,B command. The ABORT,B command checkpoints all 
the nonbuffered devices and aborts level 3 recovery. Selecting the ABORT,B command 
automatically deselects the ABORT command. The AUTOLOAD command toggles the 
selection of buffer controller autoloading. The GRENADE command toggles the selection of 
the grenade function. The AUTO command toggles the selection of the DSD AUTO 
command. Refer to table 2-1 for more information about the AUTOLOAD and GRENADE 
commands. When you are done making changes, enter 

GO. 

to continue the deadstart recovery. If you choose not to display the level 3 options, the 
default values are used. 

A level 3 recovery deadstart is impossible after: 

• An attempted checkpoint recovery (level 1). 

• An aborted level (initial) deadstart. 

• The MREC utility (refer section 8, K-Display Utilities) has been run for the machine to 
be deadstarted while in multimainframe mode. 
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It is recommended that you stop system activity prior to beginning the system deadstart 
procedure. To accomplish this, enter the following DSD commands: 



Command 



Description 



E,M. Displays the disk status display (E,M). 

UNLOCK Unlocks the system console. This command is necessary only if the 

system console is locked. 

CHECK POINT Provides for termination of job processing and for writing the contents 
SYSTEM. of central memory tables to mass storage. For a complete description of 

this process, refer to the CHECK POINT SYSTEM command in 

section 5, DSD Commands. 



STEP. 



Prevents the system from processing PP requests. This stops all 
central memory input/output (I/O) operations. You should enter the 
STEP command after all device checkpoints are completed. Determine 
checkpoint status from the disk status display (E,M) (refer to the NOS 
Version 2 Operations Handbook). 



NOTE 



To recover interactive users after a level 3 recovery, sense switch 1 must be set in the IAF 
procedure. Sense switch 1 is set by default in the released IAF procedure. 
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Level 1 Recovery Deadstart 

Usually you perform a level 1 recovery deadstart to resume normal processing following 
maintenance procedures. The system, all jobs, and all active files are recovered from 
checkpoint information on mass storage. 



NOTE 



A level 1 recovery deadstart is not intended to be a recovery process after a system/ 
equipment malfunction. You should never attempt it after a level 3 recovery deadstart fails. 

Level 1 recovery is also useful in system test situations. If two systems are being alternated, 
separate mass storage devices and tapes 2 must be available for both systems. Tapes are not 
repositioned after a level 1 deadstart. Thus, if a job was previously assigned to the tape unit 
that has been used for deadstarting, the job cannot be recovered. The tape unit should be 
left unloaded after recovery until it is no longer assigned to the job (job aborted). 

The following rules apply when performing a level 1 recovery deadstart. 

• The DSD command CHECK POINT SYSTEM must have been successfully completed 
immediately before the end of the last NOS operating period. 

• The contents of the extended memory must not be destroyed from the time of the 
CHECK POINT SYSTEM command. 

• Memory dumps must be completed before level 1 recovery deadstart begins since 
memory confidence testing destroys the contents of both central memory (except on 
CYBER 180-class machines) and PPs. 

• The mass storage equipment configuration must be the same as specified during the 
most recent level deadstart; that is, the same EQPDECK must be used. 

• The system devices (mass storage devices on which the system library resides) must be 
the same as or fewer than those specified during the most recent level deadstart. 

It is recommended that you stop system activity before beg innin g the system deadstart 
procedure. To accomplish this, enter the following DSD commands: 

Command Description 



UNLOCK Necessary only if console is currently locked. 

CHECK POINT Provides for termination of job processing and for writing the 

SYSTEM. contents of central memory tables to mass storage. 

STEP. Prevents the system from processing PP requests. This stops all 

central memory I/O operations. 



2. Separate tapes are necessary only if tape jobs are being checkpointed. 
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Level 2 Recovery Deadstart 

Usually you perform level 2 recovery deadstart in system test situations; it is not 
recommended for the normal production environment. If you select level 2 recovery, all jobs 
and active files are recovered from checkpoint information on mass storage as in level 1 
recovery. However, no attempt is made to recover the system. Instead, the system is loaded 
from the deadstart file as in level deadstart. In all other respects, level 2 recovery is 
identical to that described for level 1, and all level 1 rules apply. 
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Level Initial Deadstart 

Use level or initial deadstart in cases where a recovery deadstart is not possible. This is a 
complete or initial load from the deadstart file. Only preserved files, which include 
permanent files, queued files, and system dayfiles, are recovered (preserved files are 
recovered on all levels of system deadstart). Because memory confidence testing destroys 
the contents of central memory (except on CYBER 180-class machines) and PPs, all memory 
dumps must be completed before deadstart begins. 



NOTE 



If the machine is the first machine being deadstarted in a shared device multimainframe 
environment, you must enter a PRESET command (refer to section 13, Multimainframe 
Operations). ^_ 



Error Processing 

If no CTI display appears when you initiate a deadstart, perform the following steps as 
needed. After each step, reinitiate the deadstart to see if the problem has been eliminated. 

Deadstart from tape: 3 

1. If the unit select switch on the deadstart tape unit is not on (tape does not move), check 
the channel, controller, and unit selections on the deadstart panel or display to ensure 
they are set correctly. 

2. If the unit select switch is on, the correct unit was selected; however, check word 11 of 
the deadstart panel or display to ensure it is set correctly. 

3. Ensure that a 7-track tape is not mounted on a 9-track drive or vice versa. Also, ensure 
that a deadstart tape is not mounted on a tape unit that does not support the density of 
the deadstart tape. 

4. Ensure that the deadstart tape is an I-format unlabeled tape. 

5. Ensure that the card reader and tape unit (667 or 669 only) are not on the same 
channel and that the card reader is not on a channel with a PP. Also, ensure that two 
or more units do not have the same physical unit number. 

6. If still no display appears after initiating the deadstart, there might be a parity error 
on one of the first records of the deadstart tape or the magnetic tape controller might 
have detected a channel parity error on a CYBER 170 Computer System. 



3. When deadstarting a CYBER 180-class machine, the disk containing the CIP module must be used. 
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Deadstart from disk: 

1. Ensure that disk power is on and the disk is ready for operation. 

2. Ensure that the disk has the CIP module loaded. 

3. Ensure that the deadstart panel or display is set correctly. 

4. Select an alternate channel. 

5. If still no display appears after initiating the deadstart, there might be a parity error 
on one of the first records of the deadstart file or the disk controller might have 
detected a channel parity error on a CYBER 170 Computer System. 

For a proper understanding of the problems that can occur during deadstart, you should be 
familiar with several basic concepts. For example, because most errors that occur involve 
mass storage devices, you should be familiar with their use in the system. Each mass 
storage device has a label that contains descriptive information about its contents. For 
certain levels of recovery deadstart, this information must be consistent with corresponding 
information either contained in central memory or provided through deadstart procedures. 
Conflicts can result in the system issuing deadstart error messages. An attempt is made to 
recover all mass storage devices defined in the EST during all levels of system deadstart. 

Recovery Functions 

The specific recovery function performed depends upon the level of deadstart selected. The 
table on the following pages describes the recovery function performed for each deadstart 
level and the types of errors you can encounter. The system response to errors and the 
recommended action are also listed. 

Refer to the NOS Version 2 Operations Handbook for information concerning all deadstart 
messages. 
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Error Processing 

Error Idle Recovery 

Setting the device error idle status helps to prevent error propagation by inhibiting new file 
assignment on the device and by inhibiting any new PFM, PFLOAD, or QLOAD activity 
from occurring on the device. The error idle status is indicated by the EI error code on the 
E,M display. Error idle status is set when: 

• Mass storage read or write errors occur in the catalog or permit chains. 

• There is an incorrect user index in the permit sector. 

• Direct or indirect access files are too long or too short. 

Correcting the error idle condition requires total initialization of the affected device. This 
can be accomplished online for a removable device, but must be performed during a level 
deadstart for a nonremovable device. Suggested recovery procedures follow. 

Removable Device 

1. Dump inactive queued files, if present on the device (QDUMP). 

2. Dump permanent files (PFDUMP). 

3. Perform a total initialization of the device dNITIALIZE,AL,est.). If the error idle status 
was caused by a mass storage error, the appropriate track should be flawed. 

4. Reload inactive queued files, if applicable (QLOAD). 

5. Reload permanent files (PFLOAD). 

Nonremovable Device 

1. Dump queued files (QDUMP). 

2. Terminate any dayfiles that must be saved (DFTERM). 

3. Dump permanent files (PFDUMP). 

4. Idle the system and perform a level deadstart. 

5. Perform a total initialization of the device affected by the error idle condition 
(INITIALIZE^L,est.). If the error idle status was caused by a mass storage error, the 
appropriate track should be flawed. 

6. Reload queued files (QLOAD). 

7. Reload permanent files (PFLOAD). 
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DDP ROLLOUT PATH 3-142 

DFPT 3-142 

ENGR 3 " 143 

FLEXIBLE PARTITIONS 3- 143 

FORCED FORMATTING 3 " 144 

LOCK 3 " 145 

LOGGING 3 " 145 

MASTERMSE S-l 46 

MS VALIDATION 3-l 4 6 

OQSH 3 - 147 

PCLASS 3 - 147 

PF VALIDATION 3-148 

PRIVILEGED ANALYST MODE 3-148 

PRIVILEGED RDF 3 - 149 

QUEUE 3 " 149 

REMOVABLE PACKS 3-151 

RESIDENT RDF 3-151 

SECONDARY USER COMMANDS 3-151 

SECURES 3-152 

SERVICE 3-153 

SPINDOWN 3-158 

SRST 3-158 

SYSTEM DEBUG 3-159 

TAPE PF STAGING 3-160 

UNLOCK 3-160 

USER EXTENDED MEMORY 3-160 
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Deadstart Decks 



Deadstart decks are text records that reside on the deadstart file. This section describes the 
following deadstart decks. 

Deck Description _^____ 



CMRDECK Central memory resident deck. 

EQPDECK Equipment deck. 

APRDECK Auxiliary mass storage parameter deck. 

IPRDECK System installation parameter deck. 

LIBDECK System library deck. 

This section contains detailed information about how you can modify the released versions 
of the deadstart decks. 
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CMRDECK 

The central memory resident deck (CMRDECK) resides on the deadstart file as a text record 
that is processed during system initialization. It contains entries defining the following 
types of information. 

• Central memory. 

• Table sizes. 

• Configuration information not oriented to equipment. 

The deadstart file can contain up to 100 8 CMRDECKs. Having several CMRDECKs on the 
same deadstart file is advantageous because one file can deadstart several configurations. 
You can obtain a listing of all CMRDECKs by accessing the system file SYSTEM with an 
ASSIGN or COMMON command, then using the T parameter on the CATALOG command 
(refer to the NOS Version 2 Reference Set, Volume 3 for more information concerning these 
commands). CMRDECKs are named CMRDnn, where nn is from 00 to 77 8 . 

You can modify the released settings of the CMRDECK in two ways: type a new entry when 
the CMRDECK is displayed during deadstart, or create a new deadstart file. The usual 
method of modifying a CMRDECK follows. 

1. Deadstart, using the released deadstart file, and select the CMRINST and the 
CMRDECK to be displayed (refer to section 2, Deadstart). 

CMRINST lists all valid CMRDECK entries. Default values, described in this section, 
are assumed if the entries do not appear in the CMRDECK being used. If either 
CMRDECK or CMRINST overflows two screens, you can page the display. 

2. Modify the released version of CMRDECK by entering the changes or additions from 
the system console while either the CMRDECK or CMRINST is displayed. Each console 
entry supersedes the value currently specified in the CMRDECK (or the default value). 

NOTE 

The modified CMRDECK remains in effect only until the next deadstart is performed, 
except for a level 3 deadstart. That is, changes to the CMRDECK are not recovered 
across level 0, 1, and 2 deadstarts unless a new deadstart file is created to reflect them. 

3. To expedite subsequent deadstarts, modify the CMRDECK on the deadstart file using 
SYSGEN (refer to the NOS Version 2 Installation Handbook). 

When constructing or modifying a CMRDECK separate parameters with commas and 
terminate each entry with a period. When an error exists in an entry in a CMRDECK on 
the deadstart file, the CMRDECK is displayed and the error is indicated. This occurs even 
if you do not select the display CMRDECK option. 
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Central Memory Descriptions 

The general function of central memory description entries is to assign the amount of 
central memory to be used for central memory resident (CMR) and the amount to be used 
for job processing. The simplified relationship is: the more central memory that is assigned 
to tables in CMR, the less is available for job field lengths. 

If you will run only a few batch jobs, fewer control points may be required. Thus, you could 
decrease the control point area in CMR, which requires 200 8 words per control point. 

The following entries are specified in the SET program with the released default values 
listed. 



Entry 
Format 



Released 

Default 

Value 



BSP=option. 



Significance 



Specifies whether NOS should build the SCI parameter 
table. If the table is built by NOS, then one copy of SCI 
services MDD mode and the NOS/VE console in a 
dual-state environment. 



NOTE 



For compatibility, if NOS 2.6.1 level 700 is run in a 
dual-state environment with a NOS/VE system which is 
pre-1.3.1 level 700, then you must enter the BSP entry 
in order to use MDD. 



option Description 



N 



If Y is specified, the SCI parameter table is 
built in the NOS CMR. 
If N is specified, the SCI parameter table is 
not built in the NOS CMR unless the NOS 
console is a CC598B or CC634B. In this case, 
the table is always built. 



CLT=number. 



Specifies the octal number of common library table 
(CLT) entries allowed. The number can range from to 

7777 8 . 

The first entry in the table is reserved for the system; so 
you should equate CLT with the number of entries you 
want, plus 1. For example, if you want three entries, 
enter CLT=4. 

Common library table entries are described in the 
IPRDECK entry COMLIB. 
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Entry 
Format 



Released 

Default 

Value 



Significance 



DFT=mode. 



Depends on 

mainframe 

model 



The dedicated fault tolerance (DFT) entry specifies 
whether to run DFT in dedicated mode or in 
nondedicated mode. In dedicated mode, the DFT PP is 
loaded during the NOS deadstart process and DFT 
resides in the PP for the life of the system. Dedicated 
mode allows the halt-on-error hardware feature of the 
models 960, 990, 994, and 995 to be used. It also results 
in capturing the relevant data about hardware errors 
closer to the actual point of failure. In nondedicated 
mode, DFT is called to process mainframe errors when 
necessary. The default for models 960, 990, 994, and 995 
is DFT=Y; the default for all other models is DFT=N. 

mode Description 

D If D is specified, DFT runs in dedicated mode. 

DFT also runs in dedicated mode if the VE 
CMRDECK entry is specified (other than VE=*). 

N If N is specified, DFT runs in nondedicated 

mode (unless the VE CMRDECK entry is 
specified). 



EJT=number. 620 8 



EMB=number. 200 8 



EQP=number. Number of 
CMRDECK 



Specifies an octal number of entries for the executing 
job table (EJT). The system uses the EJT entries to 
keep track of executing jobs. 

The maximum value for number is 7777 8 ; the minimum 
value is 3. 

Specifies the number of CM words for the error message 
buffer (EMB). Error messages are placed in the EMB 
before being written to one of the system dayfiles. 

The maximum value for number is 7777 8 ; the minimum 
value is 200 8 . 

Specifies the number of the EQPDECK to use at 
deadstart. The EQPDECK contains equipment 
assignments. Up to 100 8 EQPDECKs can exist on a 
deadstart file; the number can range from 00 to 77 8 . 

If an EQP entry is not included in the CMRDECK the 
system uses the EQPDECK with the same number as 
the CMRDECK being used. 
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Entry 
Format 



Released 

Default 

Value 



FNT=number. 23 



8 



Significance 



Sets the octal number of entries allowed in the system 
file name table (FNT). The system FNT contains the 
system file and all fast-attach files. 

Determine the necessary number of FNT entries by 
using the formula: 

number = SY+RS+ (VL+PR) *FM+SFA 

Variable Description 

SY Number of system files. 

RS Number of resource files. 

VL Number of VALIDUs files per family. 

PR Number of PROFILa files per family. 

FM Number of families that can be active at any 

one time. 

SFA Site defined fast-attach files. 



FOT=number. 10 8 



For a system installed with the released defaults and 
with no additional files added to the system FNT by 
local code, the maximum number of FNT entries 
necessary is 201 8 - 

The maximum value for number is 7777 g ; the minimum 
value is 3. 

Sets the number of entries in the family ordinal table 
(FOT). Each family is allowed one entry in the table. 
The first entry in the FOT is reserved for system use. 
The system uses family name and user index for job 
ownership and file routing. The family ordinal is a 6-bit 
number that corresponds to a particular family name. 
The FOT maintains the family name to family ordinal 
relationship. If a family is unloaded and later reloaded, 
it continues to use the same family ordinal. 

The maximum value for number is 100 8 ; the minimum 
value is 3. The size of the FOT need not be the same for 
each mainframe in a multimainframe environment. 
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Entry 
Format 



Released 

Default 

Value 



Significance 



INB=number. 



IPD=number. 



First 

IPRDECK on 
deadstart file 



LDT=number. 



Specifies a block of memory for site use. The size of the 
installation block can range from to 7777 8 central 
memory words. 

Specifies the number of the IPRDECK to use at 
deadstart. The IPRDECK contains installation 
parameters. Up to 100 8 IPRDECKs can exist on a 
deadstart file; the number can range from 00 to 77 8 . 

If an IPD entry is not included in the CMRDECK, the 
first IPRDECK on the deadstart tape is processed and is 
not displayed. 

Specifies the number of central memory words allocated 
to the LID table. The minimum value is 0; the 
maximum value is 16610 8 . The value to be specified can 
be determined by using this formula: 

(3+lid)*pid 

Parameter Description 



fid 
pid 



Maximum number of LIDs allowed per 
PID. 

Total number of PIDs in all networks 
defined on this mainframe. 



LIB=number. 



MID=id. 



AA 



One central memory word is always allocated for the 
LID table header. 

As an example, assume lid=5 and pid=6. By using the 
formula, you come up with (3+5)*6=48. Adding one 
word for the LID table header makes 49, or 61 g , central 
memory words that should be allocated to the LID table. 

Specifies the number of the LIBDECK to use at 
deadstart; the number can range from 00 to 77 8 . 
LIBDECK is a directive record used by SYSEDIT. 

Specifies the 2-character machine identification (id) that 
is associated with the mainframe. The id characters 
must be alphanumeric. 
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Entry 
Format 



Released 

Default 

Value 



Significance 



MINCM=size. 1400 8 



Reserves an amount of central memory to be used by 
NOS when running in dual state with NOS/VE. The 
VEMEM utility can help you determine how NOS and 
NOS/VE will share central memory (refer to the DUAL 
installation procedure in the Special Product Installation 
Information chapter in the NOS Version 2 Installation 
Handbook for more information about VEMEM). (UEM 
is defined in the extended memory equipment EST 
entry). The remaining central memory is available for 
use by NOS/VE. Use the VE CMRDECK entry to 
reserve central memory for NOS/VE if UEM is defined. 
The TpiniTmim and default value for size is 1400 8 . 

Parameter Description 



size 



The size of central memory to reserve in 
words/lOOg. Size is a 1- to 4-digit octal 
value (1- to 5-digit octal value for a 
model 865, 875, or CYBER 180-class 
machine) that restricts the actual central 
memory size. The value cannot be and 
cannot exceed the total number of words 
of memory present in the machine. Refer 
to table 3-1. 



Size 


CM Words 


CM Words 


(Octal) 


(Octal) 


(Decimal) 


1400 


140000 


49152 


2000 


200000 


65536 


3000 


300000 


98304 


4000 


400000 


131072 


6000 


600000 


196608 


10000 


1000000 


262144 


14000 


1400000 


393216 


20000 


2000000 


524288 


24000 


2400000 


655360 


30000 


3000000 


786432 


34000 


3400000 


917504 


40000 


4000000 


1048576 


44000 


4400000 


1179648 


50000 


5000000 


1310720 


54000 


5400000 


1441792 


60000 


6000000 


1572864 


64000 


6400000 


1703936 


70000 


7000000 


1835008 


74000 


7400000 


1966080 


100000 


10000000 


2097152 
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Entry 
Format 



Released 

Default 

Value 



Significance 



NAME=date 
line. 



NETWORK 
OPERATING 

SYSTEM 



NCP=number. 12 



■8 



Specifies the system date line, which is displayed on the 
system console display and on the terminal when an 
interactive user logs in to the system. 

Parameter Description 

date line Alphanumeric string; must be fewer than 

39 characters. If the date line is not 
terminated with a period, one will be 
appended. If the date line is 38 
characters, the last character must be a 
period. 

Sets the number of control points available for job 
processing. Refer to Job Control Information later in 
this section for a discussion of the proper number of 
control points to select. 

Parameter Description 

number Number of control points available in 

central memory; number can be from 2 to 
34 8 . 
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Entry 
Format 



Released 

Default 

Value 



Significance 



OPSECM=n. 



or 
omitted 



Specifies the operating system security mode. The site 
security administrator supplies the value for this entry. 
Refer to the NOS Version 2 Security Administrator's 
Handbook for information on this entry. 

n Description 

Sets the system to unsecured mode. 

Enables multilevel security. The values of 
the system access level limits can be set by 
the SECURES IPRDECK entry or by the 
console command. The SECURES console 
command can be used to raise or lower 
system access level limits. 

Enables multilevel security. The values of 
the system access level limits are set by the 
SECURES IPRDECK entry. The SECURES 
console command can be used to raise but not 
to lower system access level limits. 

Enables multilevel security. The values of 
the system access level limits are set by the 
SECURES IPRDECK entry only; the 
SECURES console command is not allowed. 



PCP=number. 



Sets the number of pseudo-control points available for 
job processing. Refer to Job Control Information later in 
this section for a discussion of the proper number of 
pseudo-control points to select. 

Parameter Description 

number Number of pseudo-control points 

available in central memory; number can 
be from 2 to 34 8 . 
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Released 
Entry Default 

Format Value Significance 



PPU=p Pl) 
pp 2 ,...,pp n . 



All available 
PPs are active 



QFT=number. 620 8 



Toggles the active status of the physically available 
PPs 1 except for PPs 1, 2, and 10, which are always 
active. Active means the PP is available for system use; 
inactive means it is not available for system use. The 
PPU entry is not in the released CMRDECK; therefore, 
all available PPs are active. PPU is a toggle entry: each 
entry changes the active status of the PPs. 

Parameter Description 

ppj Number of the PP; from to 11 8 and 20 8 

to 31 8 . Specifying an asterisk (*) on the 
entry instead of ppj toggles the status of 
PPs 20 8 to 31 8 . 

This entry may be useful if PP memory is failing or if a 
channel is causing problems on its associated PP. For 
example, the following entry deactivates PP 3 and PP 4 
(assuming no other entries have been made for PP 3 
and PP 4). 

PPU=3 , 4 . 

Sets the number of entries allowed for the queued file 
table (QFT). The system uses the QFT to manage all 
files in the input and output queues, number is a 1- to 
4-digit number from 3 to 7777 8 . 



1. A PP that has been turned off by CTI is physically unavailable and cannot be turned on by the PPU entry. 
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Released 
Entry Default 

Format Value Significance 



VE=size. * For NOS and NOS/VE dual state only. Sets the size of 

central memory reserved for NOS/VE, in octal words 
divided by 1000 8 . You must specify this value if NOS 
UEM is defined by either the XM or EQ EQPDECK 
entry. Otherwise, you can set VE to zero and specify the 
amount of memory reserved for NOS with the MINCM 
entry. For a list of memory sizes, refer to table 3-1. 

NOS/VE requires at least 6.5 megabytes of central 
memory. On a machine with more than 128MB of 
central memory, NOS can use only the first 128MB for 
CM and UEM. Memory in excess of 128MB can be used 
only by NOS/VE. 

The VEMEM utility can help you determine how 
NOS/VE and NOS will share central memory (refer to 
the DUAL installation procedure in the NOS 2 
Installation Handbook for more information about 

VEMEM). 

If you do not want to run NOS/VE in dual-state mode, 
use VE=* or omit the VE entry. 

On a dual-CPU CYBER 180-class machine, NOS cannot 
use the second CPU if dual-state mode is selected by the 
VE entry. This is because NOS/VE does not support 
dual-state operation in the second processor. 

To cause NOS to use both CPUs on a dual-CPU CYBER 
830 or 960-32 mainframe, omit the VE entry (or specify 
VE=*) in the CMRDECK 

To cause NOS to use both CPUs on a dual-CPU CYBER 
860- or 990-class mainframe, select an OS LOAD 
STATE of NOS-NOS/BE DUAL CPU on the Operator 
Intervention menu under CIP. When this OS LOAD 
STATE is selected, the VE entry is not accepted from 
the CMRDECK. 

For all other CYBER 180-class machines, NOS cannot 
use the second CPU. 
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Entry- 
Format 



Released 

Default 

Value Significance 



VERSION=name. NOS 2.7.2 774 



Specifies the system version that is displayed on the 
system console display. Specify an alphanumeric 
string fewer than 18 characters. If name is not 
terminated with a period, one will be appended. If 
name is 17 characters, the last character must be a 
period. 

The operating system version number should be in 
character positions 5 through 7 of the name 
parameter, since the value in character positions 5 
through 7 is available to users through the CCL 
symbolic name VER. 



Table 3-1. Table of Central Memory Sizes 



CM Words CM Words CM Words 
Size 1 (Octal) (Decimal) (Hexadecimal) 



CM Megabytes 2 



400 


400000 


131072 


20000 


1MB 


1000 


1000000 


262144 


40000 


2MB 


2000 


2000000 


524288 


80000 


4MB 


4000 


4000000 


1048576 


100000 


8MB 


10000 


10000000 


2097152 


200000 


16MB 


20000 


20000000 


4194304 


400000 


32MB 


40000 


40000000 


8388608 


1000000 


64MB 


100000 


100000000 


16777216 


2000000 


128MB 


200000 


200000000 


33554432 


4000000 


256MB 


400000 


400000000 


67108864 


8000000 


512MB 



1. Value specified for size on the VE entry. 

2. MB represents megabytes. One megabyte is 1,048,576 8-bit bytes, which is equivalent 
to 100,000 hexadecimal 8-bit bytes or 131,072 60-bit words. 
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EQPDECK 

The equipment deck (EQPDECK) resides on the deadstart file as a text record that is 
processed during system initialization. It contains entries defining the following types of 
information. 

Dayfile buffer size. 

Hardware configuration. 

File residence on mass storage devices. 

Permanent file family residence. 

Multimainframe configurations. 

Software attributes associated with hardware (such as forms code). 

An EQPDECK entry is described under the type of information it defines. 

The deadstart file can contain up to 100 8 EQPDECKs. Having several EQPDECKs on the 
same deadstart file is advantageous because one file can deadstart several configurations. 
You can obtain a listing of all EQPDECKs by accessing the system file SYSTEM with a 
COMMON command, then using the T parameter on the CATALOG command (refer to the 
NOS Version 2 Reference Set, Volume 3 for more information concerning these commands). 
EQPDECKs are named EQPDnn, where nn is from 00 to 77 8 . 

You can modify the released settings of the EQPDECK in two ways: type a new entry when 
the EQPDECK is displayed during deadstart, or create a new deadstart file. The usual 
method of modifying an EQPDECK follows. 

1. Deadstart, using the released deadstart file, and select the EQPINST and the 
EQPDECK to be displayed (refer to section 2, Deadstart). 

EQPINST lists all valid EQPDECK entries. Default values, described in this section, 
are assumed if the entries do not appear in the EQPDECK being used. If either 
EQPDECK or EQPINST overflows two screens, you can page the display. 

2. Modify the released version of EQPDECK by entering the changes or additions from the 
system console while either the EQPDECK or EQPINST is displayed. Each console 
entry supersedes the value currently specified in the EQPDECK (or the default value). 



NOTE 



The modified EQPDECK remains in effect only until the next level 0, 1, or 2 deadstart 
is performed. That is, changes to the EQPDECK are retained across a level 3 deadstart, 
but not across a level 0, 1, or 2 deadstart (unless a new deadstart file is created to 
reflect them). 



3. To expedite subsequent deadstarts, modify the EQPDECK on the deadstart file using 
SYSGEN (refer to the NOS Version 2 Installation Handbook). 

Several equipment status displays are available during deadstart (refer to section 2, 
Deadstart). 
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When constructing or modifying an EQPDECK, the following restrictions apply: 

• The equipment assignment entry (EQ) must precede any other assignments for a device 
(such as assigning it for permanent file, system, or temporary file use). If you redefine 
the EQ entry (by clearing the entry and retyping a new entry or by changing the device 
type in the entry), reenter all other assignments for that equipment. If you need to 
modify an EQ entry, you need only enter the changes rather than reentering the entire 
entry. You do not need to reenter other assignments for that equipment. This is 
especially useful for changing channels or units and for reconfiguring around hardware 
malfunctions. 

Example: 

The following mass storage assignments are in the EQPDECK 

EQ7=DI , ST=ON, UN=6 , CH=1 . 
PF=7,F,125, 12 5, SYSTEM, 3,200. 

If you want to specify unit 70 rather than 60, you need only enter: 

EQ7=DI,UN=70. 

You do not need to modify the PF entry. 

• EST ordinals range from 1 to 777 8 . This range depends on the value of ESMX (refer to 
PPCOM parameters in the NOS Version 2 Installation Handbook). Ordinals 1 through 
4 are reserved for pseudoequipment EST entries that are automatically defined by the 
system and cannot be changed. Ordinal 5 is reserved for extended memory if it is used 
as a link device in a multimainframe environment (refer to EQ - Extended Memory 
EST Entry later in this section). Otherwise, EST ordinal 5 can be used for any 
equipment type. 

• The device from which you are deadstarting must be defined. 

• Commas must separate parameters. 

• A period must terminate each entry. 

• Except where explicitly specified that controllers and/or equipment can be shared 
between mainframes, assume they cannot be shared. For example, NOS does not 
support sharing a two-channel tape controller between mainframes; nor does it support 
sharing mass storage controllers, except as specified in section 13, Mult im ainframe 
Operations. 

When an error exists in an entry in an EQPDECK on the deadstart file, the EQPDECK is 
displayed and the error is indicated. This occurs even if you do not select the display 
EQPDECK option or if you enter GO after displaying the EQPDECK 



3-14 NOS Version 2 Analysis Handbook 60459300 U 



EQPDECK 



Dayfile Descriptions 

One of the functions of dayfile description entries is to assign the amount of central memory 
to be used for buffers. The more central memory assigned to dayfile buffers in CMR, the 
less central memory available for job field lengths. 

If, for example, you need a large portion of central memory to run a job, it might be 
advisable to decrease the size of the dayfile buffers area in CMR to accommodate that job. 
However, when dayfile buffers are smaller, the information stored in them is written to 
mass storage more often, which requires more system overhead. 

The following entries are specified in the SET program with the released default values 
fisted. 



Entry Format 



Released 

Default 

Value 



ACCOUNT=est,length. 400 8 



Significance 



Sets the residence of the account dayfile and 
the length of the account dayfile buffer. 

The account dayfile is an accounting record 
containing information such as type and 
quantity of resources used, and job and 
execution times. This account information is 
written to the central memory account dayfile 
buffer during job processing; the central 
memory buffer is written to mass storage 
when it is full. The account dayfile buffer 
resides in CMR in the dayfile buffer area. 

Parameter Description 

est The 1- to 3-digit octal 

equipment status table (EST) 
ordinal of the equipment on 
which the account dayfile is to 
reside. A null value means the 
system uses the first system 
device it can find. If the 
existing account dayfile is 
recovered, the account dayfile 
buffer resides on that 
equipment and the est 
parameter is ignored. 

length The 3- or 4-digit octal length of 

the account dayfile buffer in 
CMR; must be a multiple of 
100 8 and less than or equal to 
1000 8 . 
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Entry Format 



Released 

Default 

Value 



Significance 



DAYFILE=est,length. 400 8 



Sets the residence of the system dayfile and 
the length of the system dayfile buffer. 

The dayfile buffer contains the dayfile 
information, which is maintained in the same 
way as the account dayfile buffer. It resides in 
CMR in the dayfile buffer area. 

Parameter Description 

est The 1- to 3-digit octal EST 

ordinal of equipment on which 
the dayfile is to reside. A null 
value means the system uses 
the first system device it can 
find. The residence of this 
dayfile is normally determined 
by the recovery of the existing 
dayfile. Use this parameter if 
no system dayfiles are 
recovered. 

length The 3- or 4-digit octal length of 

the system dayfile buffer in 
CMR; must be a multiple of 
100 8 and less than or equal to 
1000 H . 



ERRLOG=est,length. 



100c 



Sets the residence of the error log and the 
length of the error log buffer. 

The error log is a record of hardware error 
and status messages. This information is 
maintained in the same way as the account 
dayfile buffer. 

Parameter Description 

est The 1- to 3-digit octal EST 

ordinal of equipment on which 
the error log is to reside. A null 
value means the system uses 
the first system device it can 
find. If the existing error log is 
recovered, the error log buffer 
resides on that equipment and 
the est parameter is ignored. 
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Entry Format 



Released 

Default 

Value 



Significance 



ERRLOG=est,length. 
(Continued) 



Parameter Description 



length The 3- or 4-digit octal length of 

the error log buffer in CMR; 
must be a multiple of 100 8 and 
less than or equal to 1000 8 . 



MAINLOG=est,length. 400 8 



Sets the residence of the binary maintenance 
log and the length of the binary maintenance 
log buffer. The binary maintenance log is a 
record of hardware diagnostic information. 

Parameter Description 

est The 1- to 3-digit octal EST 

ordinal of equipment on which 
the binary maintenance log is 
to reside. A null value means 
the system uses the first 
system device it can find. If the 
existing binary maintenance 
log is recovered, the binary 
maintenance log buffer resides 
on that equipment and the est 
parameter is ignored. 

length The 3- or 4-digit octal length of 

the binary maintenance log 
buffer in CMR; must be a 
multiple of 100 8 and less than 
or equal to 1000 8 . 
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General Description of Equipment Assignment Entries 

The general format of the EQ entry is: 

EQest=type, keyword 1 =value 1 , . . . , keyword n =value n . 

Keyword=value entries are order independent. 

Depending on the type of equipment being denned, certain keywords are required, while 
others are optional, as shown in table 3-2. 

You can redefine an EST entry by entering an EQ entry for the EST ordinal with a different 
equipment type. This action clears the original entry before creating the new entry. You 
can also modify an EST entry by entering an EQ entry with the same equipment type and 
only the keyword(s) you want changed. 

Clear EST Assignment Entry 

Use the following entry to clear an assignment that currently exists for an EST ordinal. 
Clearing the assignment does not clear flaw entries for that equipment. The EQest=0 entry 
is not required when you are assigning the EST entry to a different type of equipment. 

EQest=0 . 

or 

EQest=. 

Parameter Description 

est EST ordinal of the equipment; est can be from 5 to 777 8 . 
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Table 3-2. Required and Optional Keywords 



Equipment 
Type 


Required 
Keywords 


Optional 
Keywords 


AT 


CH,UN,LS,PA,DR 


ST 


CC 


EQ,CH 


ST,IB 


CM 


EQ,CH 


CW,IB 


CP 


EQ,CH 


ST,ID,FC,IB 


CR 


EQ,CH 


ST,ID,IB 


CT 


CH,UN 


ST 


DB 


UN,CH 


ST,AP,IB 


DC 


UN,CH 


STAPJB 


DD 


UN 


ST,AP,IB 


DE 


SZ 


ST,MA,ET,IB 


DF 


UN,CH 


ST J AP,IB,AP,MC,IB 


DG 


UN 


ST,AP,IB 


DH 


UN,CH 


ST^APJB 


DI 


UN,CH 


ST,AP,IB 


DJ 


UN,CH 


ST,AP,IB 


DK 


UN,CH 


ST,AP,IB 


DL 


UN,CH 


ST^PJB 


DM 


UN.CH 


ST,AP,IB 


DN 


EQ,UN,CH 


ST,AP,IB 


DP 


SZ,CH 


ST,MA,ET,AP,MC,IB 


DQ 


UN,CH 


ST,AP,IB 



(Continued on next page) 
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Table 3-2. Required and Optional Keywords 



Equipment 
Type 



Required 
Keywords 



Optional 
Keywords 



(Continued from 


previous page) 




DV 


UN,CH 


ST,AP,IB 


DW 


UN.CH 


ST,AP,IB 


EA 


EQ,UN,CH 


ST,AP,IB 


EB 


EQ,UN,CH 


ST,AP,IB 


EC 


EQ,UN,CH 


ST,AP,IB 


ED 


EQ,UN,CH 


ST,AP,IB 


EE 


EQ,UN,CH 


ST,AP,IB 


EF 


EQ,UN,CH 


ST,AP,IB 


EG 


EQ,UN,CH 


ST,AP,IB 


EH 


EQ,UN,CH 


ST,AP,IB 


LE 


EQ,CH 


ST,ID,FC,TN,PS,IB 


LS 


EQ,CH 


ST,ID,FC,TN,PS,IB 


LT 


EQ,CH 


ST,ID,FC,TN,PS,IB 


LX 


EQ.CH 


ST,ID,FC,IB 


LY 


EQ,CH 


ST,ID,FC,IB 


MP 


CH 


ST,IB 


MT 


EQ,UN,CH,TF 


ST,IB 


NC 


CH 


ST,IB 


ND 


EQ,CH,PI,ND,NT 


ST,IB 


NP 


EQ,CH,PI,ND,SA 


ST,IB 


NT 


EQ,UN,CH,TF 


ST,IB 


OD 


EQ,UN,CH 


ST,IB 


RM 


CH,PT 


ST,IB 


RP 


CH 


ST,IB 


SS 


EQ,UN,CH 


ST,IB 


TT 


EQ.CH 


ST,PT,IB 


** 


WO 


Wl 



3-20 NOS Version 2 Analysis Handbook 



60459300 U 



EQPDECK 

Equipment Assignments: Nonmass Storage 

The following EST entries are described in this subsection. 

• Nonstandard equipment 

• Pseudoequipments 

• Unit record equipment 

• Magnetic tape equipment 

• Mass Storage Extended Subsystem equipment 

• Stimulator equipment 

• Network processing unit 

• CDCNET device interface 

• Network access device 

• Two-port multiplexer 

• MAP III or IV equipment 

• 6683 Satellite Coupler 

• CYBERPLUS ring port equipment 

Nonstandard Equipment EST Entry 

The nonstandard equipment EST entry allows you to define nonstandard equipment or to 
add site debugging modifications. 

Use the following format to enter the actual octal value that is to reside at that EST ordinal. 

EQest=** ,W =value ,W 1 =value 1 



Parameter Description 



est EST ordinal of the equipment; est can be from 5 to 777 8 . 

valuej The 1- to 20-digit octal value; this value is entered in the EST word i for the 

specified ordinal. The word is right-justified and zero-filled if valuej has 
fewer than 20 digits. 
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Pseudoequipments 

The system automatically defines EST ordinals through 4 as pseudoequipment EST 
entries; they cannot be used for other equipment definitions. You cannot declare, change, or 
remove pseudoequipments. 

EST Ordinal Description 



Ordinal (RD) 

Ordinal 1 (DS) 
Ordinal 2 (NE) 



Ordinal 3 (TE) 



Ordinal 4 (TT) 



This ordinal reserves an EST entry and MST entry to be used for 
device reconfiguration. 

This ordinal represents the system display console. 

The system uses 2 internally to signify that a file is assigned, but that 
no space exists on the device. If a read is tried, end-of-information 
(EOI) status occurs. If a write is attempted, the data is discarded. 

For example, you can use ordinal 2 with the permanent file utility 
(PFDUMP) to validate the integrity of a permanent file device, without 
taking the time to actually create a dump file on tape. In this case, 
enter: 

X.DIS. 

ASSIGN, NE, TAPE. 

PFDUMP. 

This causes all dump data to be discarded, even though the permanent 
file device is read and informative messages about the permanent file 
device are issued to the system console. These messages are described 
in the NOS Version 2 Operations Handbook. 

If an association is established between file name and volume serial 
number with an ASSIGN, LABEL, REQUEST, or VSN command, the 
system automatically enters EQ3 in the file's FNT/FST entry. When a 
tape having the desired volume serial number is assigned to the file, 
the system replaces EQ3 in the file's FNT/FST entry with the EST 
ordinal of the tape unit on which the tape is mounted. If a file that has 
had the file name and volume serial number association established by 
a VSN command is returned prior to attempting to assign the tape 
equipment to the file, the FNT/FST entry is canceled. 

The system assigns to this equipment a file used for either input from 
or output to an interactive terminal. This allows the system to 
determine whether a file requires the special handling needed to 
accomplish terminal input/output. Byte 4, set by the NAMIAF 
IPRDECK entry, contains the number of network terminals. 
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Unit Record Equipment EST Entry 

A unit record equipment EST entry defines channel connected card readers, card punches, 
and line printers. 

Unit record equipment connected to RHF or PSU through communications ports are defined 
in the network configuration files rather than with individual EST entries. 

EQest=type,ST=status,TN=tn,EQ=eq,CH=ch,ID=id,FC=fc,PS=ps,IB=ib. 

or 

EQest=type-P, ST=status , TN=tn,EQ=eq, CH=ch, ID=id, FC=f c , PS=ps , IB=ib. 

Parameter Description 



est EST ordinal of the unit record equipment; from 5 to 777 8 . 

type Unit record equipment type; NOS supports the following unit record 

equipments: 



type Equipment 



CR Card reader 405-3447/3649 
CP Card punch 415-3446/3644 

CP Card punch 415-30 

LR line printer 580-12 

LS 

line printer 580-16 
LT 

Line printer 580-20 
LX 

Line printer 5870 
LY 
Line printer 5970 

Specifies that a 580 printer is equipped with a programmable format 
controller. 
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Parameter Description 



TN=tn 



Print train for local batch line printer; from 1 to 7. NOS supports the 
following print trains. 

tn Print Train Description 



1 
4 



5 
6 

7 



595-1/596-1 
595-1/596-1 
595-6/596-6 

595-5/596-5 
595-6/596-6 
595-6/596-6 



CDC graphic 63/64-character set. 

CDC graphic 63/64-character set. 

ASCII graphic 95-character set or ASCII graphic 

63/64-character set. 

ASCII graphic 63/64-character set. 

ASCII graphic 95-character set. 

ASCII graphic 95-character set or ASCII graphic 
63/64-character set. 



If you set a nonsupported print train value, tn defaults to a supported value. 
If you omit tn or specify 2 or 3, the actual value of tn is 1. 

If an invalid external characteristic (EC) 2 is specified, the queued file 
processor cannot output the file. The following shows which files will print 
and which files will not print for a given print train selection. 



Print Train 


Will Print File 




Will Not Print File 


Selected 


With Specified EC 


With Specified EC 





None, B4, B6 




A4, A6, A9 


1 


None, B4, B6 




A4, A6, A9 


4 


None, A4, A6, A9 




B4, B6 


5 


None, A4, A6 




B4, B6, A9 


6 


A9 




None, B4, B6, A4, A6 


7 


None, B4, B6, A4, 
A9 


A6, 





ST=status Specifies whether unit record equipment is available for system use; enter 
one of these values: 

status Description ____ 



ON Unit record equipment is available. 

OFF Unit record equipment is ignored during system operation. 



2. Refer to the NOS Version 2 Reference Set. Volume 3 for a discussion of the ROUTE command EC parameter. 
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Parameter Description 



EQ=eq Controller number for equipment; from to 7. To determine the number for 

most unit record equipment, look at the dial switch on the controller. To 
determine the equipment number for an LX printer, use the following 
equation: 

eg * 2 + 1 = addr 

where addr is the 5870 host address obtained from the 5870 installer. 

CH=ch Number of channel to which unit record equipment is connected; from to 

13 8 and from 20 8 to 33 8 . 

NOTE 



If you want to use a card reader to perform a coldstart on a 66x tape 
controller, the card reader must be available on channel 12 8 , 13 8 , 32 8 , or 33 8 . 

To ensure that all printers are restored to their original states (such as 8 
lines per inch and auto page eject) after a master clear has been issued, all 
unit record equipment should be available on dedicated channels. If it is not, 
printers revert to 6 lines per inch, and no auto page eject status after a 
master clear is issued. 

ID=id The 1- or 2-digit octal numeric identifier assigned to the device; from to 

67 8 . This id is assigned to any output created by a job. For card readers, all 
jobs loaded from this card reader are assigned the identifier id. 

FC=fc The 2-character optional forms code assigned to a line printer or card punch. 

If the forms code is not present, the forms code field is cleared. The forms 
code must either be null (not specified) or in the range from AA to 99. 



NOTE 



The forms code cannot be assigned to a card reader. 
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Parameter Description 



PS=ps Paper size, L or S, for local batch line printer. Default is L. 

ps Description 

L Long (11 inch) paper will be mounted. 
S Short (8 1/2 inch) paper will be mounted. 

IB=ib The 1- to 4-digit octal value; this value is entered in the installation byte for 

the specified EST ordinal. Refer to EST Formats in the NOS Version 2 
Systems Programmer's Instant. 

Examples: 

EQ11=CR, ST=ON, EQ=4,CH=12 . 

EQ11=CP,EQ=5,CH=12,ST=0N. 

EQ20=LR, ST=ON, CH=12 , EQ=6 , ID=15 , FC=AA. 

EQ21=CR, ID=15 , ST=0N,EQ=7 , CH=12 . 

EQ22=LT-P, TN=6 , ST=ON, EQ=2 , CH=12 . 
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Magnetic Tape Equipment EST Entry 

The released tape subsystem supports a maximum of 16 magnetic tape units. You can 
change this value with the MUNIT parameter of COMSMTX; refer to the NOS 2 
Installation Handbook. As a minimum, NOS requires one 639, 667, 669, 677, 679, or 698 
magnetic tape unit. The format of the entry is: 

EQest=AT, ST=status , CH=ch 1 /ch 2 , UN=un, LS=lsm, PA=panel , DR=dr . 

or 

EQest=CT-n , ST=status , CH=ch 1 / ch 2 , UN=un . 

or 

EQest=MT-n, ST=status , EQ=eq, UN=un, CH=ch 1 /ch 2 , TF=tf , IB=ib. 

or 

EQest=NT-n, ST=status,EQ=eq,UN=un, CH=ch 1 /ch 2 , TF=tf , IB=ib. 

Parameter Description 



est EST ordinal of the tape unit; from 5 to 777 8 . Refer to the AT, CT-n, MT-n, or 

NT-n parameter. 

AT Equipment type: 

MT-n * AT s P ecifies Automated Cartridge Subsystem (ACS) tape units (5682 

or tape units attached to a 5477 Automated Cartridge Subsystem). 

NT" 11 • CT specifies Cartridge Tape Subsystem (CTS) tape units (standalone 

5682 tape units). 

• MT specifies 7-track reel tape units. 

• NT specifies 9-track reel tape units. 

n is the total number of tape units connected to the controller. For CTS tape 
units, n can be from 1 to 20 8 . For 677, 679, and 698 units connected to a 
7021-31/32 controller, n can be from 1 to 20 8 . For 667 and 669 units 
connected to a 7021-21/22 controller, n can be from 1 to 10 8 . 

The system automatically generates n EST entries with consecutive EST 
ordinals beginning with the ordinal specified in the est parameter. The n 
units begin with the unit number specified in the UN=un parameter. 

For either ACS tape units or 639 units, n should not be specified. If you 
specify n for 639 units, specify a value of (zero). 

For more information on configuring CTS and ACS tape units, refer to 
section 22. 
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Parameter Description 



NOTE 



To clear a CT-n, MT-n, or NT-n assignment, enter an EQest=0 entry for each 
unit. For example, to clear EQ50=MT-4,ST=ON,..., enter: 

EQ50=0. 
EQ51=0. 
EQ52=0. 
EQ53=0. 

ST=status Indicates whether the tape unit is available for access; enter one of these 
values: 



status Description 



ON Magnetic tape unit is available for access. 

OFF Magnetic tape unit is ignored during system operation. 

DOWN All access to the magnetic tape unit is inhibited for the operating 
system and user jobs. Specify DOWN if the equipment is 
malfunctioning and access is not desirable, or if the unit is to be 
used by NOS/VE in a dual-state environment (ACS, CTS, and 
9-track units only). 3 

CH=chj Number of the channel(s) to which the tape unit is connected, from to 13 8 

and from 20 8 to 33 g . 

A controller can be connected to one or two channels, depending on the 
controller model. However, a maximum of two channels can be handled 
regardless of the number of controllers. 

UN=un Number of the lowest numbered magnetic tape unit to be processed; units 

must have consecutive physical unit numbers; from to 7 for 667 and 669 
units, or from to 17 8 for 677, 679, 698, and 5682 units. The unit number is 
on the front of the tape unit, either as a switch or a label. 

LS=lsm Index of the library storage module (LSM) containing the tape unit; from 

to 17 8 . This parameter is specified only for ACS tape units. 

PA=panel Index of the LSM panel containing the tape unit; from to 13 8 . This 
parameter is specified only for ACS tape units. 



3. If a magnetic tape unit is accessible from more than one mainframe, concurrent use must be disabled. For reel tapes, use one of 
these methods: set access switches on the tape controller so that only one mainframe can access the unit at any time or make sure 
that the EST entry for each shared unit is denned as ON in only one of the mainframes. For cartridge tapes, make sure that the 
EST entry for each shared unit is denned as ON in only one of the mainframes. 
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Parameter Description 



DR=dr Index of the tape unit (tape drive) in the LSM panel; from to 3. The index 

indicates the position of a cartridge tape unit in a cartridge tape cabinet. If 
the panel contains only two tape units, their indexes must be and 2. This 
parameter is specified only for ACS tape units. 

EQ=eq Controller number for the tape unit; from to 7. This number is usually 

unless the controller is switched to a different number. Ask your customer 
engineer for the correct number if you are unsure. This parameter is omitted 
from the EST entry for ACS and CTS tape units. 

TF=tf Hardware features available. This parameter specifies the following 

hardware characteristics of the tape unit(s) being defined; select one option. 
This parameter is omitted for both ACS and CTS tape units. 

The following options apply to 677/679/698 units: 

tf Description 

ATS The unit(s) being denned cannot process 6250-cpi 

group-encoded (GE) tapes. If the system detects a unit with 
this capability, it automatically changes this value to ATSGE 
or CMTGE, indicating the availability of the GE feature. 

ATSGE The unit(s) being defined can process 6250-cpi GE tapes, 

or Specify this value (ATSGE for 679; CMTGE for 698) only if a 

CMTGE unit being defined has the capability of processing GE tapes 

but is down. In such a case, the system would not be able to 
connect to the unit to determine the availability of the GE 
feature. 

The following options apply to 667/669 units: 

tf Description 

MTS The FCOs needed to implement the block identification feature have 
been installed in the 7021 controller for the unit(s) being defined. If 
the controller is a two-channel model, the block identification 
feature must have been implemented on both channels. 

The following options apply to 639 units: 

tf Description 

1ST Specify TF-IST. 

IB=ib The 1- to 4-digit octal value; this value is entered in the installation byte for 

the specified EST ordinal. Refer to EST Formats in the NOS Version 2 
Systems Programmer's Instant. 
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Mass Storage Extended Subsystem EST Entry 

The Mass Storage Extended Subsystem (MSE) hardware consists of a 7991 storage module 
and a 7990 controller. 

A mainframe that runs SSSLV in slave mode must have an MSE EST entry, even though 
no MSE hardware is actually configured for this mainframe. A mainframe that runs 
SSEXEC in master mode must have an LBC EQPDECK entry with a controlware type of 
N8 or M8 specified. 

The MSE EST entry format is: 

EQest=SS , ST=status , EQ=eq, UN=un, CH=ch , IB=ib. 

Parameter Description 

est EST ordinal of the 7990 controller; from 10 8 to 777 8 . 

SS Indicates a 7990 controller. 

ST=status Specifies whether the 7990 controller is available for use; enter one of these 
values: 

status Description 

ON 7990 controller is available. 

OFF 7990 is ignored during system operation. 

EQ=eq Logical controller number. 

This number sets the controller location in the unit device table within 
SSEXEC's memory. Enter one of these values: 

eg Description 

First 7990 controller. 

2 Second 7990 controller. 

4 Third 7990 controller. 

6 Fourth 7990 controller. 

UN=un 7991 storage module unit number; must be (zero). 

CH=ch Number of the channel to which the 7990 controller is connected; from to 

13 8 and from 20 8 to 33 8 . You can specify up to two channels. 

IB=ib The 1- to 4-digit octal value; this value is entered in the installation byte for 

the specified EST ordinal. Refer to EST Formats in the NOS Version 2 
Systems Programmer's Instant. 
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Stimulator Equipment EST Entry 

NOS IAF supports a stimulator called STTMULA. However, there are other stimulators 
such as PACER that can use this EST entry. (PACER is a product that can be ordered from 
the Special Products Library.) 

The format of the EST entry used by the interactive subsystem during stimulation is: 

EQest=TT, ST=status, EQ=eq, CH=ch, PT=lines, IB=ib. 

Parameter Description 



est EST ordinal of the interactive stimulator; from 5 to 777 8 . 

TT Indicates an interactive stimulator. 

ST=status Specifies whether the interactive stimulator is available for use; enter one of 
these values: 



status Description 



ON Stimulator is available. 

OFF Stimulator is ignored during system operation. 

EQ=eq Number of the controller; from to 7. Refer to the description of the channel 

parameter. 

CH=ch Number of the channel; from to 13 8 and from 20 8 to 33 8 . The 

channel/controller combination must not have any equipment attached to it. 

PT=lines Number of lines to stimulate; from 1 to 1000 8 . If this parameter is omitted, 
100 8 is used. 

IB=ib The 1- to 4-digit octal value; this value is entered in the installation byte for 

the specified EST ordinal. Refer to EST Formats in the NOS Version 2 
Systems Programmer's Instant. 
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Network Processing Unit EST Entry 

A total of 16 NPU, MDI, and MTI ESTs can be available (ST=ON) at the same time. 
The format of the EST entry is: 

EQest=NP, ST=status , EQ=eq, PI=pip, CH=ch, ND=node , SA=sa, IB=ib. 

Parameter Description 



est EST ordinal of the NPU; from 5 to 777 8 . 

NP Indicates a 255x NPU. 

ST=status Specifies whether the NPU is available for use; enter one of these values: 

status Description . 



ON NPU is available. 

OFF NPU is ignored during system operation. 

EQ=eq Number of the controller for the NPU; from to 7. 

PI=pip Peripheral interface program index, which determines which copy of the PP 

driver drives this NPU; from 1 to 4. Up to four EST entries can have the 
same PIP index (that is, one PP can drive a total of four front ends 
consisting of NPUs, MDIs, or MTIs). 

CH=ch Number of the channel to which the NPU is connected; from to 13 8 and 

from 20 8 to 33 8 . 

ND=node Node number of the coupler associated with the NPU being defined; from 1 
to 377 8 . This value is the same as the NODE parameter on the COUPLER 
statement in the network configuration file definition. For the procedure to 
assign this value, refer to the Network Definition Language Reference 
Manual. 



NOTE 



The node parameter is specified as an octal value on the NPU entry. The 
NODE parameter is specified on NDL statements as a decimal value. 
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Parameter Description 

SA=sa System autostart module (SAM) flag (refer to CCP in the NAM Host 

Application Programming Reference Manual). This parameter is required. 

sa Description 



ON SAM is present on the NPU. 

OFF SAM is absent. The host attempts to load the system autostart 

module program (SAM-P) to the NPU if the NPU is down. 

If an NPU is channel-connected to a single host in a single-host network, the 
NPU does not need a SAM. However, if an NPU is channel-connected to two 
hosts, the NPU should have a SAM; otherwise, both hosts might attempt to 
reload SAM-P if the NPU is down. This requires operator intervention to 
resolve the problem. The NPU EST entries for both hosts should specify 
SA=ON. 

IB=ib The 1- to 4-digit octal value; this value is entered in the installation byte for 

the specified EST ordinal. Refer to EST Formats in the NOS Version 2 
Systems Programmer's Instant. 

Example: 

Assume that three NPUs exist on channels 4, 5, and 6, all with controller 7. The NPUs are 
connected to coupler nodes 2, 8, and 11, respectively. The NPU on channel 5 has a system 
autostart module; the others do not. The first two NPUs are to be driven by the same PP. 
The EST entries for these NPUs follow. 

EQ70=NP, ST=ON, CH=4 , EQ=7 , PI=1 , ND=2 , SA=OFF . 
EQ71=NP, ST=ON, CH=5 , EQ=7 , PI=1 , ND=10 , SA=ON. 

EQ72=NP, ST=ON, CH=6 ,EQ=7 , PI=2 ,ND=13 , SA=OFF. 

The NDLP input for the network configuration would include the following statements 
(refer to the Network Definition Language Reference Manual for a complete description of 
these statements). 

CPLl : COUPLERNODE=2 , HNAME=HOSTl . 
CPL2 : COUPLERNODE=8 , HNAME=HOSTl . 

CPL3: COUPLERNODE=ll,HNAME=HOSTl. 

The node parameter of the EST entry and NODE on the COUPLER statement have the 
same numeric values, in this case 2, 8 (10 8 ), and 11 (13 8 ). 



60459300 U Deadstart Decks 3-33 



EQPDECK 

CDCNET Device Interface EST Entry 

Each mainframe device interface (MDI) or mainframe terminal interface (MTI) in a 
CDCNET network that is connected to a CYBER mainframe must have an EST entry. A 
total of 16 MDI, MTI, and NPU ESTs can be available (ST=ON) at the same time. The 
format of the EST entry is: 

EQest=ND,ST=status,EQ=eg,PI=pip,CH=ch,ND=node,NT=node,IB=ib. 

Parameter Description ^ ___^^_ 

est EST ordinal of the MDI or MTI; from 5 to 777 8 . 

ND Indicates an MDI or MTI. 

ST=status Specifies whether the MDI or MTI is available for use; enter one of these 
values: 

status Description 

ON MDI or MTI is available. 

OFF MDI or MTI is ignored during system operation. 

EQ=eq Number of the controller for the MDI or MTI; from to 7. 

PI=pip Peripheral interface program (PIP) index, which determines which copy of 

the PP driver drives this MDI or MTI; from 1 to 4. Up to four EST entries 
can have the same PIP index (that is, one PP can drive a total of four front 
ends consisting of MDIs, MTIs, or NPUs). 

CH=ch Number of the channel to which the MDI or MTI is connected; from to 13 8 

and from 20 8 to 33 8 . 

ND=node 4 Node number of the coupler associated with the MDI or MTI being denned; 
from 1 to 377 8 . 

NT=node 4 Node number of the MDI or MTI; from 1 to 377 8 . This node number 

identifies the Control Data Network Architecture (CDNA) transport function. 

IB=ib The 1- to 4-digit octal value; this value is entered in the installation byte for 

the specified EST ordinal. Refer to EST Formats in the NOS Version 2 
Systems Programmer's Instant. 



4. The procedure for assigning node numbers and creating network configuration file definitions is described in the Network 
Definition Language Reference Manual. 
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The node numbers assigned to an MDI or MTI must be consistent with those assigned to a 
255x NPU network configuration denned through NDL. To minimize the impact on existing 
255x NPU networks, assign node numbers as follows: 

1. Assign the lowest node numbers to NPU coupler nodes. 

2. Reserve node numbers subsequent to those assigned in step 1 for NPU nodes. 

3. Assign the remaining node numbers to MDI or MTI coupler nodes. 

4. Reserve one node number to identify the CDNA transport function. 

Network Access Device EST Entry 

The format for the network access device (NAD) EST entry is: 

EQest=NC , ST=status , CH=ch, IB=ib . 

Parameter Description ^^ 



est EST ordinal of the NAD; from 5 to 777 8 . 

NC Indicates a NAD. 

ST=status Specifies whether the NAD is available for use; enter one of these values: 

status Description 



ON NAD is available. 

OFF NAD is ignored during system operation. 

CH=ch Number of the channel to which the NAD is connected; from to 13 8 and 

from 20 8 to 33 8 . 

IB=ib The 1- to 4-digit octal value; this value is entered in the installation byte for 

the specified EST ordinal. Refer to EST Formats in the NOS Version 2 
Systems Programmer's Instant. 
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Two-Port Multiplexer EST Entry 

The two-port multiplexer (TPM) must be described in the EST to allow use of the Remote 
Diagnostic Facility (RDF) on models 865 and 875 and CYBER 180-class machines. 

The format of the TPM EST entry is: 

EQest=RM,ST=status,PT=pt,CH=ch,IB=ib. 

Parameter Description 

est The 1- to 3-digit octal EST ordinal of the TPM; 5 to 777 8 . 

RM TPM equipment type. 

ST=status Specifies whether the TPM is available for use; enter one of these values: 

status Description 

ON TPM is available. 

OFF TPM is ignored during system operation. 

PT=pt Port number to be used by RDF; or 1. RDF normally uses port 1. RDF and 

the system console cannot use the same port number. 

CH=ch Channel number on models 865 and 875 and CYBER 180-class machines; 

channel 15 is required. 

IB=ib The 1- to 4-digit octal value; this value is entered in the installation byte for 

the specified EST ordinal. Refer to EST Formats in the NOS Version 2 
Systems Programmer's Instant. 
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MAP m or IV Equipment EST Entry 

The MAP III or IV equipment EST entry allows use of the matrix algorithm processor 

(MAP). 

The format of the MAP III or IV EST entry is: 

EQest=MP, ST=status, CH=ch, IB=ib. 

Parameter Description 



est EST ordinal of MAP; from 5 to 777 8 . 

MP Indicates MAP equipment. 

ST=status Specifies whether the MAP is available for use; enter one of these values: 



status Description 

ON MAP is available. 

OFF MAP is ignored during system operation. 

CH-ch Number of the channel to which the MAP is connected; from to 13 8 and 

from 20 8 to 33 8 . 

IB=ib The 1- to 4-digit octal value; this value is entered in the installation byte for 

the specified EST ordinal. Refer to EST Formats in the NOS Version 2 
Systems Programmer's Instant. 



6683 Satellite Coupler EST Entry 

The 6683 satellite coupler EST entry allows use of the NOS-SCOPE 2 Station Facility. The 
format for the entry is: 

EQest=CC , ST-status , EQ=eq, CH=ch , IB=ib . 
Parameter Description 



est EST ordinal of 6683 coupler; from 5 to 777 8 . 

CC Indicates 6683 coupler. 

ST-status Specifies whether the 6683 coupler is available for use; enter one of these 
values: 



status Description 



ON 6683 coupler is available. 

OFF 6683 coupler is ignored during system operation. 

EQ=eq Controller number for equipment; from to 7. 

CH=ch Number of channel to which coupler is connected; from to 13 8 and from 20 8 

to33 8 . 

IB=ib The 1- to 4-digit octal value; this value is entered in the installation byte for 

the specified EST ordinal. Refer to EST Formats in the NOS Version 2 
Systems Prograinmer's Instant. 
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CYBERPLUS Ring Port EST Entry 

The CYBERPLUS ring port equipment EST entry allows use of the CYBERPLUS 
Subsystem. The format of the entry is: 

EQest=RP,ST=status,CH=ch, IB=ib. 

Parameter Description 

est EST ordinal of the ring port; from 5 to 777 g . 

RP Indicates ring port. 

ST=status Specifies whether the ring port is available for use; enter one of these values: 

status Description 

ON Ring port is available. 

OFF Ring port is ignored during system operation. 

CH=ch Number of the channel to which ring port is connected; from to 13 8 and 

from 20 8 to 33 8 . This parameter is required. 

IB=ib The 1- to 4-digit octal value; this value is entered in the installation byte for 

the specified EST ordinal. Refer to EST Formats in the NOS Version 2 
Systems Programmer's Instant. 
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Optical Disk EST Entry 

The optical disk EST entry allows use of optical disk units from Large Storage 
Configurations, Incorporated. You can have both standalone optical disk units and multiple 
units housed in a jukebox. The format of the entry is: 

EQest=OD, ST=status . CH=ch, EQ=eq, UN=un, IB=ib. 
Parameter Description ^ 



est EST ordinal of the optical disk unit; from 5 to 777 8 . 

OD Indicates optical disk unit. 

ST=status Specifies whether the optical disk unit is available for use; enter one of these 
values: 

status Description 



ON Optical disk unit is available. 

OFF Optical disk unit is ignored during system operation. 

DOWN All access to the optical disk unit is inhibited for the operating 

system and user jobs. Specify DOWN if the equipment is 

malfunctioning and access is not desirable. 

CH=ch Number of the channel to which the optical disk unit is connected; from to 

13 8 and from 20 8 to 33 8 . 
EQ=eq Optical disk formatter (equipment) number for this unit; from to 7. 

UN=un Optical disk control module (unit) number; from to 17 8 . Use unit numbers 

to 7 for standalone optical disk units. Use unit numbers 10 8 to 17 8 for 
optical disk units housed in a jukebox. 

IB=ib The 1- to 4-digit octal value; this value is entered in the installation byte for 

the specified EST ordinal. Refer to EST formats in the NOS Version 2 
Systems Programmer's Instant. 
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Equipment Assignments: Mass Storage 

This subsection describes the following EST entries and mass storage equipment 
assignments. 



Equipment 



Disk equipment 
Control module 
Extended memory 
Mass storage allocation control 
Down channel entry 
UP channel entry 
Permanent files device 
System library device 
Alternate system library device 
System checkpoint file device 
Default family name 
Removable device 
Shared device 
Independent shared device 
Load buffer controllers 
Extended memory allocation 
UEM equipment initialization 
Set access level limits 
Set disk thresholds 



Entry 



EQ 

EQ 

EQ 

MSAL 

DOWN 

UP 

PF 

SYSTEM 

ASR 

SCKP 

FAMILY 

REMOVE 

SHARE 

ISHARE 

LBC 

XM 

UEMIN 

ACCESS 

THRESHOLD 
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NOS Mass Storage Concepts 

Following are descriptions that define the NOS mass storage terminology and summarize 
the kinds of mass storage equipment assignments that can be specified in the EQPDECK 
Table 3-3 summarizes the various functions that a particular mass storage device can serve. 
For example, if a device is an alternate system device (listed under the Alternate System 
column in table 3-3), then it cannot be a system device; it can contain temporary files, direct 
access files, and indirect access files; it can be a master device or a nonmaster device; it 
cannot be removable; it can be either an auxiliary device or a family device; and it can be a 
shared device or a link device. 

Alternate System Device 

Whereas a system device contains all the routines in the system library, an alternate 
system device contains copies of selected system library routines. The ASR entry in the 
EQPDECK (refer to ASR - Alternate System Library Device Assignment Entry later in this 
section) specifies which mass storage devices are to be alternate system devices; the *AD 
LIBDECK entry on the deadstart file specifies which system library routines are to reside 
on these alternate system devices. During system processing, the routines on the alternate 
system device are used instead of the ones on the system device. 

This feature allows each routine in the system library to reside on the mass storage device 
that is most appropriate to the routine's use. For example, instead of using an 844 system 
device, a routine that is frequently used could use extended memory, which has a faster 
transfer rate, as an alternate system device. 



NOTE 



Use care when specifying alternate system devices. A mistake could result in no alternate 
system device defined. For example, suppose you specify the following in your EQPDECR 



ASR=7 . 
ASR=11 . 



and you specify the following in the corresponding LIBDECK 



*AD , 5 , ABS/COMPASS 
*AD,11,PP/1SJ 



Since the system could not match equipment numbers between the EQPDECK and the 
corresponding LIBDECK the system library routine COMPASS will not be on equipment 7 
or 5. However, 1SJ will be on equipment 11 as specified. 
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Table 3-3. Mass Storage Functions for Various Device Types 



Other 

Possible 

Functions 


Type 1 


Type 2 


Type 3 


Type 4 


Type 5 


Type 6 


Type 7 


Type 8 


Type 9 


Alternate system 
device 


No 


- 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


System device 


- 


No 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Contain 
temporary files 


Yes 


Yes 


- 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Contain direct 
access files 


Yes 


Yes 


Yes 


— 


Yes 


Yes 


Yes 


Yes 


Yes 


Contain indirect 
access files 


Yes 


Yes 


Yes 


Yes 


- 


Yes 


Yes 


Yes 


Yes 


Master device 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Nonmaster 
device 


Yes 


Yes 


Yes 


Yes 


No 


No 


Yes 


Yes 


Yes 


Removable 
device 


No 


No 


No 


Yes 


Yes 


Yes 


No 


Yes 


No 


Nonremovable 
device 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Auxiliary device 


Yes 


Yes 


Yes 


Yes 


Yes 


- 


No 


Yes 


Yes 


Family device 


Yes 


Yes 


Yes 


Yes 


Yes 


No 


- 


Yes 


Yes 


Shared device 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


- 


- 


Link device 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


- 


- 



1. System. 

2. Alternate system. 

3. Containing temporary files. 

4. Containing direct access files. 

5. Containing indirect access files. 

6. Auxiliary. 

7. Default family. 

8. Shared. 

9. Link. 
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Alternate Permanent File Family 



More than one permanent file family can exist in a system: one default permanent file 
family and one or more alternate permanent file families. One permanent file family is 
defined as the default family by the EQPDECK FAMILY entry (refer to FAMILY - Default 
Family Name Assignment Entry later in this section). If another system's permanent file 
family is introduced, it is an alternate permanent file family; it can be added without 
interrupting the default permanent file family's operation. 

This is a useful feature if a site has more than one system or has groups of installations. If 
one system fails, its permanent files can be accessed from another system. 

As an example, a site with two systems might run with the mass storage configuration 
shown in table 3-4. 

Table 3-4. Mass Storage Configuration for Two Systems at One Site 



Access 
System Ordinal Device Spindles Used Contents 



X 7 844 2 A Direct access files 

y 7 844 2 B Direct access files 



If system Y became inoperative, the B access could be connected to system X. This could be 
done without interrupting operations of system X. 

The EQPDECK entries in system X would be: 
Entries Comments 



EQ7=DI,ST=ON,UN=0/l,CH=0/3. Defines access A. 

EQ10=DI,ST=OFF,UN=0/l,CH=l/4. Defines access B. 

REMOVE=10. Allows introduction of access B into system X 

during operation. 

The EQPDECK entries in system Y would be: 
Entries Comments 



EQ7=DI,ST=ON,UN=0/l,CH=l/4. Defines access B. 

EQ10=DI,ST=OFF,UN=0/l,CH=0/3. Defines access A. 

REMOVE=10. Allows introduction of access A into system Y 

during operation. 
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To allow for introduction of an alternate permanent file family: 

1. Define the equipment to be introduced or removed in the EQPDECKs for both systems 
(refer to the previous example). 

2. Specify all of the equipment that may be introduced or removed during system 
processing as removable. 

3. When you want to introduce the equipment into a system, use the ON operator 
command to indicate that the equipment that was set to the OFF position in the system 
in operation is now available. This introduces the alternate permanent file family. 

4. Enable the validation files for the family by entering X.ISF(FM=familyname). Refer to 
section 20, System File Initialization. 

Auxiliary Device 

An auxiliary device is a mass storage device that is not part of a family. It is a 
supplementary permanent file storage device, which may be privately owned (PRIVATE) or 
may be shared by many users (PUBLIC). An auxiliary device resides on either a removable 
or nonremovable device. On the permanent file entry (PF) for an auxiliary device (for both a 
removable device and a fixed device without packs), a pack name is specified instead of a 
family name. 

Refer to the NOS Version 2 Reference Set, Volume 3, for additional information about 
private and public auxiliary devices. 

As an example, four 844 spindles to be used as a public auxiliary device could be defined as 
follows: 

EQ6=DI , ST=ON,UN=l-4 , CH=2 . 
PF=6,X,name. 

Private auxiliary devices can be created only after the system is up and running. An 
operator can make a public device a private device by entering the INITIALIZE command 
with the UN and TY=X parameters (refer to section 8, K-Display Utilities). 
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Family Device 

A family device is a mass storage device that is part of a family. It can be either a 
removable device or a nonremovable device. The only difference between the two is that a 
nonremovable device containing permanent files can also contain a copy of the system library 
and/or temporary files. Refer to Alternate Permanent File Family earlier in this section. 

On the PF entry, the family name is important if two systems' permanent files are to run on 
the same system. A user can only use one family of permanent files at one time; if the user 
does not specify one, the default FAMILY entry is used. 

A family device can contain direct and indirect access files. These files are defined in the 
NOS Version 2 Reference Set, Volume 3. The files that are allowed are set by the device 
mask and secondary mask on the PF entry. 



Link Device 

Either extended core storage or extended semiconductor memory or STORNET is the 
medium through which several computer systems are linked to form a multimainframe 
operating environment (shared MMF). The link device contains the information necessary to 
manage the mass storage that can be shared by more than one mainframe. For a 
description of shared mass storage, refer to SHARE - Shared Device Entry and ISHARE - 
Independent Shared Device Entry later in this section. 



Master Device 

The master device contains all of the permanent file catalog entries, indirect access files, 
and file permits for a specific user. If permanent file access is required, the user's master 
device must be available on the system, unless all access is to be to an auxiliary device. The 
user index and family name uniquely describe a user's master device. 

Each master device is organized into five logical sections. 

1. Allocation information. 

A master device, like all mass storage devices, maintains device labels and track 
reservation tables (TRTs). 

The device label contains information describing the device, such as family name and 
user mask, as well as locations of permit and catalog information and indirect access 
files. Refer to the INITIALIZE - Initialization Entry later in this section 

The TRT is the key to allocating information on the master device and to describing the 
physical layout of data on the device. Refer to APRDECK later in this section. 

2. Catalog information. 

Catalog entries are used to determine the locations and attributes of permanent files. 
The catalogs for a master device are allocated to contain catalog entries for a specific 
group of user indexes. A particular catalog track may contain entries for many users, 
the number depending upon the number of catalog tracks defined for the device. The 
user index provides the mechanism for differentiating between user's files on a 
particular catalog track. 
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3. Permit information. 

Users can explicitly or implicitly allow other users to access their permanent files. 
Refer to the PERMIT command in the NOS Version 2 Reference Set, Volume 3. 
Information describing the permission for all permanent files is in the permit file. 
Catalog entries contain a relative sector address within this permit file for permissions 
that have been granted for the file. 

4. Indirect access files. 

The master device contains all of the user's indirect access files. These files can be 
accessed by commands that generate working copies for manipulation by the user. 

5. Direct access files. 

Direct access files can reside either on the master device or on another device in the 
family, depending on the device masks specified on the PF entries. Direct access files 
are files that can be accessed at their location on mass storage. A working copy is not 
generated, so any updates or alterations made to the files are permanent. 

Multispindle Device 

To accommodate files that are larger than one device, you can specify multispindle device 
assignments. Up to eight spindles of 844 disk drives or up to three spindles of 885 disk 
drives can be included in the equipment definition of one logical device, when the device is 
first defined. All spindles must be available for access whenever the device is accessed. 

Multispindle devices are treated as one logical device, having a track size equal to n times 
the single-spindle track size (n is the number of spindles in the device). The tracks of an 
n-spindle device are broken down into n equally-sized segments, each having a length equal 
to the single-spindle track size. Each segment is contained on a different physical unit. 

844 Expander 

A nonexpanded controller can have up to eight disk drives connected to it. Each of the 
connection paths is called a port and is identified by a port number ranging from to 7. An 
expander (10304 extender) is a hardware device that can be connected between controllers 
and 844 disk drives to increase the number of disk drives that each controller can access. 

The expander can be used only with 844-21 drives, although all equipment definitions and 
equipment driving software support the 64-drive addressing scheme for both 844-21 (DI/DK) 
and 844-41 (DJ/DL) type equipment. 

Each expander consists of either two or four expansion elements. An expansion element 
connects to a single controller port and forms a connection path from that port to from one 
through eight disk drives. The connection paths between an expansion element and the 
eight possible disk drives are called ranks and are identified by a rank number ranging 
from to 7. Two expanders with four expansion elements each can be connected to a single 
controller to allow that controller to access a maximum of 64 disk drives. Each expansion 
element, however, is logically independent and, as such, could be connected to any port of 
any controller. 
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A single controller maximum configuration can be visualized as an 8- by 8-square 
checkerboard with each square representing one of 64 disk drives (figure 3-1). 
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Figure 3-1. Expander Addressing Map 

A col umn of squares in figure 3-1 represents all the drives that are accessed through a 
single controller port. A row of squares represents all the drives that have the same 
expander rank. Each disk drive that can be accessed by the controller is addressed by a 
6-bit unit number. The rightmost 3 bits of this unit number select to which of the eight 
controller ports the drive is connected. The leftmost 3 bits of the unit number select to 
which of the eight ranks on an expansion element the drive is connected. This unit number 
is specified as a 2-digit octal number in the mass storage equipment EST entry (refer to 
EQ - Disk Equipment EST Entry later in this section). The right digit (port digit) of the 
unit number is the port number and the left digit (rank digit) is the rank of the unit in the 
particular expansion element. 

If two disk drives are vertically adjacent on the expander addressing map (figure 3-1), then- 
unit numbers are considered to be vertically ordered; that is, both drives are connected to 
the same expansion element, both have the same port number, and their rank numbers 
differ by one (refer to example 1). 

If two disk drives are horizontally adjacent on the expander addressing map (figure 3-1), 
their unit numbers are considered to be horizontally ordered; that is, both drives have the 
same rank number, and their port numbers differ by one (refer to example 2). The special 
case of rank numbers of for two horizontally adjacent drives is equivalent to the definition 
of consecutive unit numbers for other equipment. 

All drives connected to a controller, either directly or through an expansion element, are 
supported as single-unit or multiunit logical devices. Unit numbers can range from to 77 8 , 
rather than from to 7, as for other equipment. Thus, a maximum of sixty-four 844 disk 
drives connected to a single controller can be addressed. However, a maximum of eight 
units can be specified per multiunit device. In addition, all units of a multiunit device must 
be connected to the same channel and, therefore, to the same controller. 
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Figure 3-2 illustrates a configuration in which two expansion elements and 20 disk drives 
are connected through one controller. An expansion element with eight drives is connected 
to port 0, an expansion element with six drives is connected to port 1, and six drives are 
connected to six ports (ports 2 through 7). Each disk drive is shown as a square with its 
appropriate unit number inside. This configuration is used in the following three examples 
to illustrate multiunit device assignments. The controller is assumed to be connected to 
channel 1. Refer to EQ - Disk Equipment EST Entry later in this section for specific 
information on assigning these devices. 
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Figure 3-2. 844 Expander Configuration With 20 Drives 



NOTE 



The following examples illustrate multiunit device assignment of devices. For a description 
of the mass storage EST entry in the EQPDECK, refer to EQ - Disk Equipment EST Entry 
later in this section. 
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Example 1: 

Figure 3-3 illustrates a possible configuration for a three-unit vertically adjacent multiunit 
device. This device could be assigned in the EQPDECK, specifying EST ordinal 6, as: 

EQ6=DI,ST=ON,UN=50/ 60/70, CH=1. 
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Figure 3-3. Vertically Adjacent Three-Unit Device 

Example 2: 

Figure 3-4 illustrates a possible configuration for a two-unit horizontally adjacent multiunit 
device. This device could be assigned in the EQPDECK, specifying EST ordinal 7, as: 

EQ7=DI , ST=ON, CH=1 , UN=40-41 . 
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Figure 3-4. Horizontally Adjacent Two-Unit Device 
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Example 3: 

Figure 3-5 illustrates a possible configuration of 20 disk drives into seven devices. These 
devices could be assigned in the EQPDECK as follows: 

EQ6=DI , ST=ON, UN=60 , CH=1 . 
EQ7=DI , ST=ON, UN=70 , CH=1 . 
EQ10=DI,ST=ON,UN=50-51,CH=1. 
EQ11=DI,ST=ON,UN=10/20/30/40,CH=1. 
EQ12=DI,ST=ON, UN, 11/21/31/41, CH=1. 
EQ13=DI , ST=ON, UN=0-3 , CH=1 . 
EQ14=DI , ST=ON, UN=4-7 , CH=1 . 

Devices on ordinals 6 and 7 are defined as single units. These units may be initialized 
online into a two-unit device if they are also defined as removable. 
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Figure 3-5. Hardware Configured into Seven Devices 
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Nonremovable Device 

A nonremovable device cannot be physically removed during system operation. It can 
contain a copy of the system library, which means it is a system device; it can also be 
available for temporary files. It may or may not contain permanent files. 

Removable Device 

A removable device can be logically or physically added or removed during system operation 
without causing system malfunction. 

A device is specified as removable with the REMOVE entry in the EQPDECK During 
deadstart, a removable device is recovered just as is any other mass storage device, if the 
status is on. If the device is not available, then the status is displayed for the operator (E,M 
display). 

Removable devices can contain permanent files but cannot contain the system library or 
temporary files, because a device containing active files (such as temporary or library files) 
cannot be removed from the system. A removable device can be either an auxiliary device or 
an alternate permanent file family device. 



Shared Device 

A shared device contains permanent files that can be accessed by more than one mainframe. 
To have these permanent files accessible to the mainframe, the device must be defined as 
shared in the mainframe. Refer to SHARE - Shared Device Entry and ISHARE - 
Independent Shared Device Entry later in this section. 

A shared device can be removable. However, when unloading a shared device, it must be in 
global unload status before you remove it. Refer to the DSD commands UNLOAD and 
MOUNT in section 5 for more information concerning removable shared devices. 



System Device 

The system device is a nonremovable device on which the system library resides. It can also 
contain permanent and temporary files. 



Temporary File Device 

The temporary file device is a nonremovable device on which the following temporary 
system files reside: 

Library files 

Local files 

Queued files 

Rollout files 

System files 

Timed/event rollout files 
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Buffered Disks 

Buffered disks are those disks for which the system provides an extended memory data 
buffer. The following buffered disks are supported on the mainframes indicated: 

• The 819 Disk Storage Subsystem is available only on model 176. The buffer is kept in 
LCME. 

• The 885-42 Disk Storage Subsystem is available on all models except CYBER 180-class 
machines and model 176. The buffer is kept in ESM. 

• The 895 Disk Storage Subsystem is available on all CYBER 180-class machines except 
models 810, 815, 825, and 830. The buffer is kept in UEM. 

• The 887, 9853, and 5830 Disk Storage Subsystems are available only on CYBER 860-, 
960-, and 990-class mainframes with I4A IOU. The buffer is kept in UEM. 

• Buffered disks are not available on models 810, 815, 825, and 830. 
Using extended memory as a data buffer provides the following capabilities. 

• The system treats the buffer as a disk cache so that multiple requests for a particular 
disk data block can potentially be satisfied by doing only one disk read. 

• The system buffers data to maintain maximum transfer rates regardless of the user's 
buffer size. 

To maintain maximum transfer rates, a CPU program that resides in CPUMTR controls the 
buffered disk I/O request processing. The system maintains the standard disk I/O interface 
to the user's programs. 

The buffered disk error reporting process logs read/write errors in the binary maintenance 
log. An unrecovered read/write error is also logged in the system error log and an error 
message appears at the system control point. The binary maintenance log must be 
processed by the Hardware Performance Analyzer (HPA) to get detailed information 
concerning buffered device errors. 

The amount of I/O buffer space in extended memory is important to system performance. 
Refer to XM - Declare Extended Memory Space for Buffers or User Access later in this 
section. 

There may be situations when a particular user job runs slower with buffered disks. This 
happens if the job issues CIO reads when a buffer is full or issues CIO writes when a buffer 
is empty. (Both cases indicate inefficient programming techniques.) You can speed up the 
job by entering the DSD command ENABLE,LOGGING. The system will perform faster I/O 
and issue warning messages to the job dayfile. 

Disk Array Subsystem (DAS) 

The 5380 Disk Array Subsystem (DAS) is a disk storage subsystem that provides great 
storage capacity and operational speed. It consists of multiple disks in a storage cabinet. 
You can configure from one to three disks as a logical device; logical devices of two or more 
disks increase the storage capacity, operational speed, and/or data integrity. 
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The only disk units you can install in DAS are the 5832 Solid State Disk (SSD), the 5833 
Sabre, and the 5838 Elite. You can configure SSD units as single units or as pairs of units 
driven in parallel. You can configure 5833 Sabre units in four ways: 

• As a single unit 

• As a single unit with another unit used for parity 

• As a pair of units driven in parallel 

• As a pair of units driven in parallel with another unit used for parity 
You can configure 5838 Elite units in two ways: 

• As a single unit 

• As a single unit with another unit used for parity 

Parallel units increase the storage capacity and operational speed. A parity unit ensures 
data integrity if a unit in the logical device fails. 

When you configure a device with a parity unit, the system redundantly records data on 
both the parity unit and the nonparity unit(s). If a unit fails, the system continues to access 
data on the remaining unit(s). After the failing unit is repaired and/or replaced and you 
enter a RESTORE,est command, the system automatically restores data to the unit. While 
the data is being restored, users have access to the data on the device, although the 
effective transfer rate is somewhat degraded until the restoration is complete. 

Dual-Channel Access for 5830 and 9853 Subsystems 

Dual-channel access has several advantages: 

• Increased reliability— access to the disks can continue even when one channel/controller 
is down. 

• Increased performance— the system automatically distributes I/O requests to the two 
channels to maximize effective throughput. 

To configure dual-channel access for the 5830 and 9853 disk subsystems, the channel 
addresses within the controller or control module must be set correctly. Refer to the 
appropriate controller reference manual for a description of how to set channel addresses for 
each subsystem. 

For dual-channel access, both channels are connected to each controller, going from one 
controller to the next in a daisy-chain fashion. A request issued on a channel contains a 
channel address and is processed by one controller or the other based on the channel 
addresses set within the controller for that channel. 

The system sets the channel address in the request based on the equipment controller 
number for the disk device as defined by the EQ keyword on the EQPDECK entry for that 
device. Because only one EQ value is specified for each device, the channel address 
contained in an I/O request for a dual-channel access device is the same regardless of the 
channel on which the request is issued. 

To support this convention and to ensure that a controller does not receive requests on more 
than one channel at the same time, the channel addresses within the controller must be set 
in the following way: 
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• Set the same channel address value for the first channel of the first controller and the 
second channel of the second controller. 

• Set the remaining channel addresses (the second channel of the first controller and the 
first channel of the second controller) to some other value. You can use any value that 
does not conflict with the address used for the active channel ports for this pair of 
controllers or with the addresses of any additional controllers connected in daisy-chain 
fashion. 

The following example illustrates a configuration for dual-channel access for a 5830 disk 
subsystem. 

In this example, the logical equipment entry for a 5830 device is defined with the following 
EQPDECK entry: 

EQ010=EC,ST=ON,EQ=0,UN=0,CH=1A/2A. 

The 5830 subsystem is physically cabled as in figure 3-6. 



Chonne I Chonne I 
1A 2A 



tf 



O • 

Con tro I I er 



Equ i pment 
Numbers 




DAS 



Figure 3-6. Dual-Channel Access to 5830 Drives 

This configuration correctly configures only one channel per controller. The equipment 
number defined at each asterisk (*) can be any value other than zero (in this example) and 
does not appear in the EQPDECK 
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Because two channels are denned, a separate driver is initiated for each channel. An I/O 
request for this disk can be processed by either driver, depending only on which driver sees 
the request first. Except for error recovery, NOS does not initiate a request on one access 
and complete that request on the alternate access. Error recovery can cause a disk request 
to be processed on the alternate channel if the request cannot be successfully completed on 
the original channel. 

Extended Memory Overview 

Extended memory (EM) refers to the five types of additional memory used by NOS to 
supplement central memory space and connect mainframes. This extended memory can be 
used to store programs and data, but not to execute programs. Shown below are the five 
types of extended memory and the mainframes that support each type. Also shown are the 
maximum EM size supported by each mainframe, how each mainframe connects to the 
extended memory, and what buffered devices are supported for each EM type. 



Extended 
Memory 


Mainframe 


Maximum 
Size 


Mainframe 
Connection 


Buffered 
Device 5 


ECS 


All 


2MW 


CPU port, 6 DDP 


- 


ESM 


All 


16MW 


CPU port, 6 LSP 


885-42 


LCME 


176 


2MW 


CPU port 


819 


STORNET 


All 


4MW 


LSP 


- 


UEM 


815,825,835,865,875 

810,830 

840,845,850,855,860, 

870,910 

990,995 


2MW 
8MW 
16MW 

8MW 


No connection, 
part of mainframe's 
main memory 


895, 887, 
9853, 
583x (DAS) 



Physical Configuration 

Extended core storage (ECS) is an external memory available for all mainframes. ECS 
connects to the mainframe using either a CPU port 6 or a distributive data path (DDP) 
through a peripheral processor. 

Extended semiconductor memory (ESM) is an external memory available for all 
mainframes. ESM connects to the mainframe using either a CPU port 6 or a low-speed port 
(LSP) through a peripheral processor. 

Large central memory extended (LCME) is an external memory available only for model 176 
mainframes. LCME connects to the model 176 using a central processor unit (CPU) port. 

STORNET is an external memory available for all CYBER 170 and CYBER 180 
mainframes. STORNET connects to the mainframe using a low-speed port (LSP) through a 
peripheral processor. 



5. The buffered devices shown are not necessarily supported on all of the mainframe types indicated. 

6. A CPU port connection is not available on CYBER 180-class machines. CPU port on model 176 machines can only connect to 
LCME. 
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Unified extended memory (UEM) is a part of the mainframe's main memory and is 
separated from central memory by a partition defined at deadstart time by the site. 

All extended memory except STORNET is accessed by special instructions. Instructions 
exist for multiple word transfers (FORTRAN: Level 1 variables; COMPASS: RE/WE 
instructions) and single word transfers (FORTRAN: Level 2 variables; COMPASS: RX/WX 
instructions). The multiple word transfers are available on all mainframe types; the single 
word transfers are available only with LCME and UEM on models 176, 865, 875, and 
CYBER 180-class machines. 



Logical Configuration 

Extended memory can be used for several purposes. The physical characteristics of the 
various extended memory types differ, which affects the ways in which extended memory 
can best be used. The possibilities are: 

• To connect mainframes in a multimainframe environment (ESM, ECS, and STORNET). 

• To store system routines and data files (all EM types). 

• To supplement user central memory space (all EM types except STORNET). 

• To provide a cache buffer for buffered I/O devices (LCME, ESM, and UEM). 

ESM, ECS, or STORNET can be used as a link device to interconnect mainframes in a 
multimainframe environment. UEM cannot be used as the link device since it is part of a 
mainframe's main memory. For additional information concerning multimainframe 
operations, refer to section 13, Multimainframe Operations. 

Extended memory can be used as a mass storage device. The following system files can be 
made extended memory resident as opposed to using central memory or disk space. 

System Files Description 

Operating The alternate system residency EQPDECK entry ASR defines a device 

system to be an alternate system device. LIBDECK directives specify which 

system library routines are to be placed on the alternate system device. 

Temporary and The EQPDECK entry MSAL,T=est. or MSAL,R=est, where est is the 
rollout EST ordinal of the EM device, causes the system to use extended 

memory as a mass storage device for temporary files or rollout files. 

Secondary The EQPDECK entry MSAL,S=est., where est is the EST ordinal of the 

rollout EM device, causes jobs that are less than a specified size to be rolled 

out to extended memory. The IPRDECK entry SRST defines the size of 

the rollout files allowed in extended memory. 

System files should be placed in extended memory only if a performance improvement can 
be gained. Whether performance improves or not depends on your production environment, 
including memory and input/output requirements, available central and extended memory, 
and available disk units and channels. 

The amount of memory available to a user job can be increased by defining user-accessible 
extended memory. NOS allows user data structures to reside in memory external to the 
job's field length. (Refer to COMPASS and FORTRAN reference manuals.) 
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A portion of extended memory is reserved for users by the XM EQPDECK entry. The user's 
memory is reserved in allocation units dependent on the amount of user-accessible extended 
memory defined at deadstart. The minimum allocation unit (user EM block size [M=million] 
UEBS) varies as follows. Service limits are defined for the user in the IPRDECK in UEBS 
units. 

At least But less than Allocation unit (UEBS) 



1000 words 


1M words 


1000 8 


1M words 


2M words 


2000 8 


2M words 


4M words 


4000 8 


4M words 


8M words 


10000 8 


8M words 


16M words 


20000 8 



This means that if you define 3 million words of user-accessible extended memory and a 
user executes RFL(EC=1), that user will be assigned 4000 8 words of extended memory. 

Extended memory provides a cache buffer for buffered I/O devices. Space is allocated by the 
system for buffered I/O with the XM EQPDECK entry. In most cases, system performance 
improves as the amount of extended memory defined for buffered I/O increases. However, 
ample space must be available for other uses. 

CM and UEM Size Specification and Determination 

When UEM is defined, its size is specified on the EQ EQPDECK entry for UEM. For models 
865 and 875, the remaining memory is used for central memory. On CYBER 180-class 
machines, the remaining memory is divided between native mode (NOS/VE or EI) and 
central memory. If running in dual-state mode, the VE CMRDECK entry specifies the 
memory for NOS/VE. If ininning NOS only, central memory size equals the total memory 
size minus the EM size minus the EI size. 

Simultaneous Use of Two Types of Extended Memory 

NOS allows the simultaneous use of two types of extended memory in the following cases. 

• Models 865 and 875 can access both UEM and ESM/ECS simultaneously. The 
recommended use of this combination of extended memory is to define ESM/ECS for 
system file residence and/or as a link device in a multimainframe environment and to 
define UEM for user-accessible extended memory. Since the main memory size for 
models 865 and 875 is limited to two million words, central memory space is given up 
for any UEM defined. Also, since ESM/ECS is an external device, fewer memory 
conflicts result when it is accessed rather than UEM. 

In this case, an EQ entry is required in the EQPDECK for ESM/ECS as well as ASR 
and MSAL entries, as desired. User access is restricted to UEM via the XM entry when 
the EM parameter is specified. 

• CYBER 180-class machines can also access both UEM and ESM/ECS/STORNET 
simultaneously. The purpose of the ESM/ECS/STORNET access is to allow connection 
of CYBER 180-class machines into a multimainframe environment. In this case, 
ESM/ECS is defined in the EQPDECK as the link device and UEM is defined for 
system files, I/O buffers, and user-accessible extended memory. 



60459300 U Deadstart Decks 3-57 



EQPDECK 



An EQ EQPDECK entry is required for both ESM/ECS/STORNET, but is not required 
for UEM. The ESM/ECS/STORNET EQ entry defines the extended memory as a link 
device via the LSP/DDP. The UEM EQ, if present, entry allows the use of extended 
memory as a mass storage device. An XM entry allocates extended memory for buffered 
I/O and user access. 

Specifying Ranges of EST Ordinals 

Several EQPDECK entries allow you to specify multiple EST ordinals in the same entry. 
For example, instead of entering 

REMOVE= 6,7,10,11,12. 

you can enter: 

REMOVE=6-12. 

Ranges of ordinals can be mixed with individual ordinals, such as: 

REMOVE=6 , 10-16 , 23 . 

Empty ordinals within a range are ignored. For example, specifying a range of 6 through 12 
will ignore an unassigned ordinal 7. However, inappropriate devices within a range or 
specified individually (such as specifying a printer as a removable device) are diagnosed as 
errors. 

EQ — Disk Equipment EST Entry 

The purpose of the mass storage equipment (EQ) entries is to describe all mass storage 
peripheral equipment. This includes disk equipment and extended memory equipment. 
NOS requires that at least 6 million words of mass storage be available. 

There can be up to 200 logical mass storage devices, and therefore, up to 200 mass storage 
EST entries (this number does not include ordinals through 4, which are reserved for 
specific uses). An entry, however, can refer to more than one physical unit. For example, 
two 885 spindles can be defined as either two logical devices with two EQ entries or as one 
logical device with one EQ entry. 

A unit is a dual-access unit if it is accessed by one mainframe through two different 
controller-channel access routes. To define a unit as a dual-access unit with its EQ entry, 
specify two channel parameters. The channels should be from two controllers. Only one 
channel of a dual-channel access controller is recommended for use on a single mainframe, 
since using both channels of the controller results in a performance degradation rather than 
an improvement. Therefore, if both channel accesses of a controller are physically connected 
to the same mainframe, you should define only one of them on an EQ entry. 

NOTE 

A device's EQ entry must precede any of the following entries for that device: ASR, MSAL, 
REMOVE, PF, SYSTEM, FAMTLY, INITIALIZE, SHARE, ISHARE, ACCESS, and 
THRESHOLD. If you redefine a device's EQ entry, then you must also redefine those entries. 
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The format of the EQ entry for disk units is: 

EQest=type , ST=status , UN=units , CH=ch 1 pt 1 /ch 2 pt 2 , AP=ap , IB=ib, EQ=eq . 



Parameter 


Description 




est 


EST ordinal of the disk units; from 5 to 777 8 . 




type 


Equipment type. The following disk units are supported by NOS. 




type 

DB 7 


Equipment 


Number of Units 




885-42, 7155-401 


lto3 




DC 8 


895, 7165 


lto2 




DD 9 


834, 7255-1 


lto8 




DF 10 


887 (4K sector) 


lto3 




DG 9 


836, 7255-1 


lto3 




DH 10 


887 (16K sector) 


lto2 




DI 


844-21, 7054/7154 (halftrack) 


lto8 




DJ 


844-41/44, 7054/7154, 7155-1 (halftrack) 


lto8 




DK 


844-21, 7154 (full track) 


lto8 




DL 


844-41/44, 7154, 7155-1 (full track) 


lto8 




DM 


885-11/12, 7155-1 (halftrack) 


1 to 3 




DN 10 


9853 


1 




DQ 


885-11/12, 7155-1 (full track) 


lto 3 




DV* 1 


819 (single-density) 


1 




DW 11 


819 (double-density) 


1 




EAlO 


5380 Disk Array Subsystem; one 5832 


lto8 



SSD drive running in serial mode. 

EB 10 5380 Disk Array Subsystem; two 5832 1 to 6 
SSD drives running in parallel mode. 



7. Not applicable for CYBER 180-class machines. 

8. Applicable for CYBER 180-class machines except models 810, 815. 825, and 830. You must also 
specify the UEM EQ entry and XM entry to define the I/O buffer area in UEM. 

9. Applicable for models 810. 815, 825, and 830 only. You must also specify the control module EQ 
entry. 

10. Applicable only to CYBER 860-. 960-, and 990-class mainframes with I4A IOU. 

11. Applicable to model 176 only. 
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Parameter 



Description 



type 
(Continued) 



Equipment type. 
type Equipment 



Number of Units 



EC 12 5380 Disk Array Subsystem; one 5833 
Sabre drive running in serial mode. 

ED 12 5380 Disk Array Subsystem; two 5833 
Sabre drives: one for data and one for 
parity. 

EE 12 5380 Disk Array Subsystem; two 5833 
Sabre drives running in parallel mode. 

EF 12 5380 Disk Array Subsystem; three 5833 
Sabre drives: two for data and one for 
parity. 

EG 12 5380 Disk Array Subsystem; one 5838 
Elite drive ru nning in serial mode. 

EH 12 5380 Disk Array Subsystem; two 5838 
Elite drives: one for data and one for 
parity. 

When running NOS/VE in dual state 
with NOS, disks DI, DJ, DK, DL, DM, 
and DQ must be denned in the NOS 
EQPDECK if NOS/VE is to use them. 



lto2 



lto2 



12. Applicable only to CYBER 860-. 960-, and 990-class mainframes with I4A lOU. 
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Parameter Description 



ST=status Specifies whether or not the equipment is available for access; enter 

one of the following values: 

status Description 

DOWN All access to the equipment is inhibited for the operating 
system and user jobs. Specify DOWN if the equipment is 
malfunctioning and access is not desirable, or if the 
equipment is to be used by NOS/VE in a dual-state 
environment (only applies to disks DI, DJ, DK, DL, DM, and 
DQ). 

IDLE New files are not assigned to a device with IDLE status 
unless no suitable alternative device exists, but you may 
continue to access files already on the device as if the device 
had a status of ON. 

OFF No user jobs can access the equipment; however, system 

utilities are permitted to access the device, so it can be 
dumped or loaded. 

ON The specified equipment is generally available. 

If the equipment is removable and is not available at deadstart, the 
system determines it is unavailable, even if its EQ status entry 
specifies ON. If INITIALIZE is entered, the equipment is not initialized 
until it is set to ON status. During system operation, the operator can 
initiate access to this device by entering the ON command. 

If the equipment can be used with either one of two different systems 
(removable devices, not dual access), define the status of the EQ entry 
as ON in the system to which it is currently available for access; define 
the status of the EQ entry as OFF in the system to which it is not 
currently available for access. 

Use the ST=DOWN parameter to prevent NOS from using disks that 
are to be used by NOS/VE. This applies only to disks DI, DJ, DK, DL, 
DM and DQ (these disks must be defined in the NOS EQPDECK if 
NOS/VE is to use them). 
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Parameter 



Description 



UN=units DefiBes unit numbers). Unit numbers are configuration dependent. 

For 834 or 836 units, unit numbers are generated as follows: 

unit number = (control module physical equipment 
number)* 10 8 +(834 or 836 disk physical unit number) 

For example, in UN=10 the 1 is from the EQ=1 parameter in the 
control module entry and the is the physical unit number of the 
disk drive. 

For 819 units, unit numbers are either from to 3, if on FLPP 
channels 2 and 3, or from 4 to 7, if on FLPP channels 6 and 7. 

For 844 units, unit numbers are from to 77 8 . 

For 885 units, unit numbers are from 40 s to 77 8 . 

For 887 units, unit numbers are from to 7. 

For 895 units, unit numbers have the following format: 

unit number = shxxxx 

where: 

s = storage control address (0 or 1). 

h = head of string controller address (0 or 1). 

xxxx = spindle number (0 to 17 8 ). 

For 583x units of type EA, EC, and EG, unit numbers are from to 
37 8 . For 583x units of type EB, ED, EE, EF, and EH, unit numbers are 
from to 7; the unit number specified is the unit number of the first 
unit of the device (that is, the unit in string zero). Refer to the 5830 
Disk Array Subsystem Configuration Guide for more information on 
configuring 583x devices. 

For 9853 units, unit numbers are from to 7. 

You can define the 834, 836, 844, 885, 887, 895, and 583x physical 
units with a separate EQ entry for each unit, or, if more contiguous 
storage is needed than is possible with one unit, you can define more 
than one physical unit as one logical device with one EQ entry. If the 
EQ entry defines more than one unit of a multispindle device, specify 
unit numbers as UN=un 1 -un n , if units are contiguous, or as 
UN=un 1 /un 2 /.../un n , if units are noncontiguous. For 834, 836, and 385x 
units, all units must be on the same control module (controller). 

For example, three 885 units (0, 1, and 2) to be accessed as three units 
are defined as follows: 

EQest=DM, ST=status , UN=0 , CH=ch , AP=ap . 
EQest=DM, ST=status , UN=1 , CH=ch, AP=ap . 
EQes t=DM, ST=status , UN=2 , CH=ch , AP=ap . 
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Parameter Description 

UN=units (Continued) 

Three 885 units (0, 1, and 2) to be accessed as one logical unit are 
denned as follows: 

EQest=DM, ST=status , UN=0-2 , CH=ch, AP=ap . 

or 

EQest=DM, ST=status , UN=0/ 1/2 , CH=ch, AP=ap . 

An advantage to accessing the three units as one logical unit is that 
less space is used in CMR. A disadvantage is that if any of the units 
malfunctions or is destroyed, all units are affected. 

CH=ch! For all devices except 819, 834, 836, 887, 583x, and 9853 the number of 

the channel or channels to which the controller is connected; from to 
13 8 and from 20 8 to 33 8 . 

For 819 disks, the channel pair for input/output(I/0) multiplexer 
(primary access); enter one of these values: 



Ck) 


Description 


2 


Channels 2 and 3. 


4 


Channels 4 and 5. 


6 


Channels 6 and 7. 



For 834 and 836 disks, the channel number is specified on the control 
module EQ entry. 

For 887, 583x, and 9853 disks, the concurrent channel number from 
to llg. The first and second channel numbers must be different. 

For an 895 disk, either a normal or concurrent channel; A concurrent 
channel is specified by Cch x , or Cch 2 . For example, CH=02/C03 defines 
the channel pair as nonconcurrent channel 02 and concurrent channel 
03. Use of a concurrent channel frees up two nonconcurrent PPs for 
each channel that is moved to the concurrent I/O subsystem (CIO). If 
an 895 is used to deadstart, one channel access to the 895 must remain 
on a noncurrent channel. 

pt x For 887, 583x, and 9853 disks only, the channel port (A or B) for the 

first channel. Default is port A. 
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Parameter Description 



/ch 2 Indicates dual-access unit; connect ch x and ch 2 to different controllers. 

The system balances channel activity on dual-access units. 

For 819 disks, the secondary access channel pair; one of the values 
described for chj. 

For 834 and 836 disks, dual access is indicated on the control module 
EQ entry. 

For 887, 583x, and 9853 disks, the concurrent channel number for the 
second channel; from to 11 8 . The first and second channel numbers 
must be different. 

pt2 For 887, 583x, and 9853 disks only, the channel port (A or B) for the 

second access channel. Default is port A. 

AP=ap The 1- or 2-digit octal number that indicates which APRDECK to use. 

If AP=ap is omitted, the first APRDECK, APRDOO, is assumed. 

IB=ib The 1- to 4-digit octal value; this value is entered in the installation 

byte for the specified EST ordinal. Refer to EST Formats in the NOS 
Version 2 Systems Programmer's Instant. 

EQ=eq Control module (controller) number for the 583x or 9853 disk. Control 

module numbers are from to 7. 
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EQ — Control Module EST Entry 

An 834 or 836 Disk Storage Subsystem consists of from one to eight 834 or from one to 
three 836 disk units and the corresponding control modules. To be operational, both the 
disk units and the control modules must be defined in the EQPDECK The EQ entry for the 
834 or 836 disk units is described under EQ - Disk Equipment EST Entry earlier in this 
section. The description of the EQ entry for a control module follows. 

A control module for the 834 or 836 Disk Storage Subsystem is a controller that drives up to 
four 834 or three 836 disks and that interfaces with the operating system using one or two 
7255-1 adapters (one per channel). The control module EQ entry is used to: 

• Specify the channels to be used to access the 834 or 836 drives defined on the control 
module. Channel entries are not allowed on the 834 or 836 disk unit EQ entries. 

• Specify what level of controlware is to be loaded into the control module during 
deadstart or when you use a LOADBC command. 



• 



Allow maintenance access to a control module without affecting other control modules 
on the same channel(s). 



The format of the control module entry is: 

EQest=CM,EQ=eq,CH=ch 1 /ch 2 ,CW=cw, IB=ib. 

Parameter Description 



est EST ordinal of the control module; from 5 to 777 8 . 

EQ=eq Physical equipment number of the control module; from to 7. Each control 

module must be assigned a unique equipment number. 

CH=ch 1 Number of the channel to which the control module is connected; from to 
13 8 and from 20 8 to 33 8 . 

/ch 2 Indicates a dual-access control module; from 1 to 13 8 and from 20 8 to 33 8 . 

CW=cw Indicates the control module type and whether controlware is to be installed 

in the control module during deadstart. The control module load sequence 
takes at least 15 seconds for each control module. It is advised that you load 
controlware only when necessary, cw can be one of these values: 



cw Description 



CM Control module for 834 disk. Install controlware (default). 

NCM Control module for 834 disk. Do not install controlware. 

C2 Control module for 836 disk. Install controlware. 

NC2 Control module for 836 disk. Do not install controlware. 

IB=ib The 1- to 4-digit octal value; this value is entered in the installation byte for 

the specified EST ordinal. Refer to EST Formats in the NOS Version 2 
Systems Programmer's Instant. 
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EQ — Extended Memory EST Entry 

NOS supports the following types of extended memory. 

Large Central Memory Extended (LCME) 

Extended Core Storage (ECS) 

Extended Semiconductor Memory (ESM) 

Unified Extended Memory (UEM) 

STORNET 

Refer to the Extended Memory Overview earlier in this section for an explanation of the 
various physical and logical configurations using extended memory. Also refer to the 
Examples of EQPDECK Entries for Extended Memory to see examples of how to use 
EQPDECK entries to define extended memory for both single mainframe and 
multimainframe configurations. 

You can use extended memory as an alternate system residency for often accessed system 
routines. The faster access may result in a performance improvement. However, you should 
use caution when placing system routines in UEM to avoid possible performance 
degradation instead of an improvement. This can happen because a portion of central 
memory is reserved for UEM and therefore that portion is unavailable to users. Also, 
accessing the system routines that reside in UEM may require additional CPU overhead. 
Use the ACPD and PROBE utilities (refer to TRACER/PROBE Utilities, section 21) to 
determine the impact on system resources when using UEM. 

NOTE 

If extended memory is not included in the hardware configuration, do not make an extended 
memory EST entry. 

The format of the entry is: 

EQest=type , ST=status , MA=mode , ET=xmem/ddp/nc , SZ=size , Cl^chj/ ch 2 , AP=ap , MC=mc , IB=ib . 

Parameter Description 

est EST ordinal of the extended memory equipment; from 5 to 777 8 . If you are 

using extended memory as a Unk device in a multimainframe environment, 
est must be ordinal 5. Otherwise, extended memory can be denned as any 
EST ordinal in the given range. 

type Extended memory equipment type; enter one of these values: 

type Description 

DE DDP or LSP is not available. 

DP DDP or LSP is available (not applicable for UEM). 
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Parameter Description 



ST=status Specifies whether extended memory is available for access; enter one of these 
values: 

status Description 



MA=mode 



ET=xmem/ 
ddp/nc 



ON Extended memory is available. 

OFF Extended memory is ignored during system operation. 

Maintenance mode (not applicable for UEM). If you specify MA=ON, online 
extended memory diagnostics are allowed to reference the half of extended 
memory that is placed in maintenance mode at the controller. The other half 
of extended memory is available to the system. The size of available physical 
extended memory is divided by 2 at deadstart. 

When you initially place an extended memory device in maintenance mode, 
all mainframes using the extended memory must initiahze it. When you 
place ECS in maintenance mode, you must also make the PRESET entry for 
multimainframe operation. Refer to INITIALIZE and PRESET later in this 
section. If you omit the MA=mode parameter, the default is MA=OFF. 

If you use part of extended memory in maintenance mode and you have 
ESM, you must also use the MC=mc parameter to define which maintenance 
port to use. 

Type of large memory and ddp. If you specify ddp, you must also specify 
xmem. If this parameter is not specified, El/Dl is assumed. 



xmem Description 



El ECS I for all mainframes. 

E2 ECS II for all mainframes. 

LE LCME only for model 176. 

EM UEM for models 865 and 875 and CYBER 180-class machines. 

Type must be DE. The system ensures that the sum of memory 
words specified by the MINCM CMRDECK entry and specified by 
this entry for UEM is present. 

ES ESM for all mainframes. 

SN STORNET for all CYBER 170 and CYBER 180 mainframes. 



ddp Description 



Dl DC135 DDP. Default for xmem of El or E2. 

D2 DC145 (parity enhanced) DDP, or ESM low-speed port (LSP). 

Default for xmem of ES and SN. 

nc Description _________ 



NC Indicates type DP does not have a CPU coupler. NC is not valid for 

xmem of DE. Default for xmem of SN. 
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Parameter Description 



SZ=size Size of extended memory in words/1000 8 . This value must not be larger than 

the size of the physical memory that is present. 

• For ECS II and LCME, size can range from a minimum of 10 8 to a maximum of 10000 8 . 

• For STORNET, size can range from a minimum of 10 8 to a maximum of 20000 8 . 

• For ESM, size can range from a minimum of 10 8 to a maximum of 100000 8 . 

• For UEM, size can range from a minimum of 10 8 to a maximum of (100000 8 -CM size). 
NOTE 

Since CIP uses a small amount of CM, you may need to make allowances for CIP when 
you enter a value for size. 

• For ECS I, size is one of the values in the following table: 



Size 


ECS I 




(Octal) 


Available 


Number of Banks 


400 


125K 13 


1 


1000 


250K 


2 


2000 


500K 


4 


4000 


1000K 


8 


10000 


2000K 


16 



The following table shows the value in EM words (both octal and decimal) and megabytes 
for a given value of size: 



Size 


EM Words 


EM Words 




(Octal) 


(Octal) 


(Decimal) 


EMMei 


10 


10000 


4096 




400 


400000 


131072 


1MB 


1000 


1000000 


262144 


2MB 


2000 


2000000 


524288 


4MB 


4000 


4000000 


1048576 


8MB 


10000 


10000000 


2097152 


16MB 


20000 


20000000 


4194304 


32MB 


40000 


40000000 


8388608 


64MB 


100000 


100000000 


16777216 


128MB 



13. K is 1000 60-bit words. 
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Parameter Description ________ 

CHfcchj/cl^ Numbers of the channels to which the DDP or low speed port is connected; 
from to 13 8 and from 20 8 to 33 8 . 

If the equipment type is DE, do not specify a channel parameter. If a 
channel parameter is specified, the system recognizes the DE entry as a DP 
entry. 

If the equipment type is DP, specify either one or two channels. The second 
channel cannot be (zero). If a DDP or low speed port is present, the 
loading of CPU programs residing in ECS or ESM still occurs via the CPU. 
A DDP or low speed port must be connected to a channel by itself. 

AP-ap The 1- or 2-digit octal number that indicates which APRDECK to use. If 

you omit AP-ap, the first APRDECK, APRDOO, is assumed. 

MC=mc Number of the channel to which the maintenance port is connected; from 1 

to 13 8 and from 20 8 to 33 8 . Channel cannot be used for the maintenance 
port. This channel is for ESM only and must be specified for proper 
reporting of ESM errors. 

IB=ib The 1- to 4-digit octal value; this value is entered in the installation byte 

for the specified EST ordinal. Refer to EST Formats in the NOS Version 2 
Systems Programmer's Instant. 
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Examples of EQPDECK Entries for Extended Memory 

The following examples show the EQPDECK entries that are necessary to define extended 
memory in various configurations. 

Single Mainframe Examples 

The EST ordinal of extended memory equipment ranges from 5 to 777 8 . For single 
mainframe configurations, extended memory can be defined as any EST ordinal in the given 
range. For these examples, the machine identifier of the mainframe is assumed to be AA 

Example 1: 

This example shows a CYBER 170 mainframe with ESM connected via the high-speed port. 
ESM can be used as a mass storage device, user-accessible extended memory, and for 
885-42 disk I/O buffers. 

EQ6=DP, ET=ES, ST=ON, SZ=10000 , CH=32 . (Define 2 million words of ESM.) 

MSAL , S= 6 . (Define ESM as secondary rollout 

device.) 
asr=6 . (Define ESM as alternate system 

residency device.) 
XM= AA ,3000,1000. (Allocate 3000000 octal words for 

885-42 I/O buffers and 1000000 octal 

words for user-accessible extended 

memory.) 

Example 2: 

This example shows a CYBEE 180-class machine with part of its mainframe memory 
defined as UEM, which can be used as a mass storage device, for user-accessible extended 
memory, and for 887, 895, or 9853 disk I/O buffers. 

EQ7=DE, st=on, et=em, sz=2000 . (Define 1/2 million words of memory 

as UEM.) 

XM=AA ,1000,200. (Allocate 1000000 octal words for 895, 

887, or 9853 I/O buffers and 200000 
octal words for user-accessible 
extended memory.) 

NOTE 

If you are irinning a dual-state system, the VE CMRDECK entry affects the amount of 
memory available for NOS and thus for UEM. 
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Example 3: 

This example shows a CYBER 180-class machine where UEM is used only for 
user-accessible extended memory, not as a mass storage device or for I/O buffers. No EQ 
entry for UEM is necessary in this case. 

XM=AA ,,200. (Allocate 200000 octal words for 

user-accessible extended memory.) 

Example 4: 

This example shows a CYBER 170 model 865 or 875 mainframe with no ESM. Part of the 
mainframe memory is defined as UEM and is used as a mass storage device and for 
user-accessible extended memory. UEM cannot be used for 885-42 disk I/O buffers. 

EQ11=DE, ST=ON, ET=EM, SZ=2000 . (Define 1/2 million words of UEM.) 

MSAL , S=ll - (Define UEM as secondary rollout 

device.) 

ASR=11 . (Define UEM as alternate system 

residency device.) 

XM=AA, ,200. (Allocate 200000 octal words for 

user-accessible extended memory.) 

Example 5: 

This example shows a CYBER 170 model 865 or 875 mainfra m e with no ESM (as in 
example 4) except that UEM is used only for user-accessible extended memory and not as a 
mass storage device. No EQ entry for UEM is necessary in this case. 



XM=AA, ,200. 



(Allocate 200000 octal words for 
user-accessible extended memory.) 
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Example 6: 

This example shows a CYBER 170 model 865 or 875 mainframe with ESM connected via 
the high-speed port. ESM is used as a mass storage device, for 885-42 I/O buffers, and for 
user-accessible extended memory. No UEM is defined. 

EQ10=DP, st=on, et=es, SZ=10000 , CH=7 . (Define 2 million words of ESM.) 

MSAL , S=10 . (Define ESM as secondary rollout 

device.) 

ASR=10 . (Define ESM as alternate system 

residency device.) 

XM=AA ,3000,1000. (Allocate 3000000 octal words for 

885-42 I/O buffers and 1000000 octal 
words for user-accessible extended 
memory in ESM.) 

Example 7: 

This example shows a CYBER 170 model 865 or 875 mainframe with ESM connected via 
the high-speed port. ESM is used as a mass storage device and for 885-42 disk I/O buffers. 
Part of the mainframe's memory is defined as UEM and used for user-accessible extended 
memory. 

You have the option on CYBER 170 model 865 and 875 mainframes to define user-extended 
memory either in ESM or UEM. If ESM is present, as indicated by an EQ entry for it, then 
user-accessible extended memory resides in ESM by default. However, you can force 
user-accessible extended memory to reside in UEM with the EM parameter on the XM 
entry. 885-42 disk I/O buffers must reside in ESM. 

EQ10=DP, ST=ON, ET=ES, SZ=10000, CH=7 . (Define 2 million words of ESM.) 

MSAL , S=10 . (Define ESM as secondary rollout 

device.) 

ASR=10 . (Define ESM as alternate system 

residency device.) 



XM=AA, 3000, 1000, EM. 



(Allocate 3000000 octal words for 
885-42 I/O buffers in ESM and 
1000000 octal words for 
user-accessible extended memory in 

UEM.) 
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Multimainframe Examples 

For all multimainframe configurations, the extended memory link device must be defined as 
the equipment with EST ordinal 5. The machine identifiers of the connected mainframes 
are assumed to be AA and AB. The following examples do not show the SHARE EQPDECK 
entries that are required to indicate multimainframe operation. 

Example 1: 

This example shows two CYBER 170 mainframes linked to ESM via high speed ports. In 
addition to being the link device, ESM can also be used as a mass storage device, for 885-42 
disk I/O buffers, and for user-accessible extended memory. 



EQ5=DP, ST=ON, ET=ES, 37=10000, CH=5 . 
XM=AA,1000,200. 



XM=AB, ,400. 



(Define 2 million words of ESM.) 

(Allocate 1000000 octal words for 
885-42 I/O buffers and 200000 octal 
words for user-accessible extended 
memory in ESM for machine AA.) 

(Allocate 400000 octal words for user- 
accessible extended memory in ESM 
for machine AB.) 



The EQPDECK entries for the linked mainframe would be the same as shown above; the 
link device (ESM) is defined as equipment 5 and both XM entries must be present. 
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Example 2: 

This example shows two linked CYBER 180-class machines connected to ESM via low-speed 
ports. Part of the mainframe memory for machine AA is denned as UEM, which is used as a 
mass storage device, for 895, 887, or 9853 disk I/O buffers, and for user-accessible extended 
memory. On CYBER 180-class machines, user-accessible extended memory and 887 or 895 
disk I/O buffers must reside in UEM; they cannot reside in ESM. 



EQ5=DP,ST=ON,ET=ES/D2/NC,SZ=10000,CH=4. 



EQ6=DE, ST=ON, ET=EM, SZ=2000 . 



MSAL,S=6. 



ASR=6 . 



XM=AA, 1000,200. 



(Define ESM as the link device. NC 
indicates that there is no CPU access 

to ESM.) 

(Define 1/2 million words of UEM; 
without this EQ entry, UEM can be 
used only for user-accessible extended 
memory.) 

(Define UEM as secondary rollout 
device.) 

(Define UEM as alternate system 
residency device.) 

(Allocate 1000000 octal words for 895, 
887, or 9853 I/O buffers and 200000 
octal words for user-accessible 
extended memory in UEM.) 

The EQPDECK for the linked CYBER 180-class machine AB might look like the following. 
This mainframe has part of its memory defined as UEM used only for user-accessible 
extended memory. 

EQ5=DP, ST=ON, ET=ES/D2/NC, SZ=10000, CH=4. (Define ESM as the link device.) 

XM=AB ,,200. (Allocate 200000 octal words for 

user-accessible extended memory in 
UEM. Since no EQ entry is present 
for UEM, it cannot be used as a mass 
storage device or for I/O buffers.) 

The XM entries appear only in the EQPDECK for the machine where the memory is being 
allocated. Do not place them in the EQPDECKs of any linked mainframes. 
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Example 3: 

This example shows a CYBER 170 mainframe connected to ESM via a high-speed port 
linked to a CYBER 180-class machine connected to ESM via a low-speed port. 



EQPDECK for CYBER 170 

EQ5=DP, ST=ON, ET=ES, SZ=10000 , CH=5 . 
MSAL,S=5. 

ASR=5. 

XM=AA, 1000, 400. 



(Define ESM as the link device.) 

(Define ESM as secondary rollout 
device.) 

(Define ESM as alternate system 
residency device.) 

(Allocate 1000000 octal words for 
885-42 I/O buffers and 400000 octal 
words for user-accessible extended 
memory in ESM.) 



EQPDECK for CYBER 180 

EQ5=DP, ST=ON, ET=ES/D2/NC, SZ=10000 , CH=4 . 
EQ6=DE, ST=ON, ET=EM, SZ=2000 . 



MSAL,S=6. 



ASR=6. 



XM=AA, 1000,400. 



XM=AB, 1000, 200. 



(Define ESM as the link device.) 

(Define 1/2 million words of UEM; 
without this EQ entry, UEM can be 
used only for user-accessible extended 
memory.) 

(Define UEM as secondary rollout 
device.) 

(Define UEM as alternate system 
residency device.) 

(Linked 170 XM entry must be 
present to define user-accessible 
extended memory and 885-42 I/O 
buffers in ESM.) 



(Allocate 1000000 octal words for 895, 
887, or 9853 I/O buffers and 200000 
octal words for user-accessible 
extended memory in UEM. This entry 
cannot be in the 170 EQPDECK) 
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Example 4: 



This example shows a CYBER 170 model 865 or 875 connected to ESM via a low-speed port 
linked to a CYBER 180-class machine also connected to ESM via a low-speed port. This 
configuration allows continued system operation if the high-speed port to ESM from the 
CYBER 170 model 865 or 875 was down. 



EQPDECK for CYBER 170 model 865 or 875 

Note that ESM cannot be used for user-accessible extended memory or for 885-42 I/O 
buffers if a high-speed port is not present. 



EQ5=DP,ST=ON,ET=ES/D2/NC,SZ=10000,CH=4. 
EQ11=DE,ST=ON,ET=EM,SZ=2000. 



MSAL,S=11 



ASR=11. 



XM=AA, ,200, 



(Define ESM as the link device; NC 
indicates that there is no CPU access.) 

(Define 1/2 million words of UEM. 
This is allowed; in contrast to 
example 8 earlier, because ESM has 
no CPU access.) 

(Define UEM as secondary rollout 
device.) 

(Define UEM as alternate system 
residency device.) 

(Allocate 200000 octal words for 
user-accessible extended memory in 
UEM. This entry cannot be in the 180 
EQPDECK) 



EQPDECK for CYBER 180 

EQ5=DP,ST=ON,ET=ES/D2/NC,SZ=10000,CH=4. 
EQ6=DE,ST=ON,ET=EM,SZ=2000. 



MSAL,S=6. 



ASR=6 . 



XM=AB, 1000, 200. 



(Define ESM as the link device.) 

(Define 1/2 million words of UEM; 
without this EQ entry, UEM can be 
used only for user-accessible extended 
memory.) 

(Define UEM as secondary rollout 
device.) 

(Define UEM as alternate system 
residency device.) 



(Allocate 1000000 octal words for 895, 
887, or 9853 I/O buffers and 200000 
octal words for user-accessible 
extended memory in UEM. This entry 
cannot be in the 170 EQPDECK) 
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MSAL — Mass Storage Allocation Control Entry 

The MSAL entry assigns job files of the specified type to the mass storage devices defined by 
the specified EST ordinal. 

The format of the MSAL entry is: 

MSAL,t=est 1 ,est 2 , • - . ,est n . 

Parameter Description 



File type; one of these values: 



"i 



t Description 



B LGO files. 

D Job dayfiles. 

I Input files. 14 

L Local files. 

O Output files. 14 

P Primary files. 

R Rollout files. 

S Secondary rollout files. 

T Temporary files. 



est 4 EST ordinal of a nonremovable mass storage device, from 5 to 57 8 . Ranges of 

ordinals can be specified. 



NOTE 



In most cases, using ESM or UEM as a secondary rollout device improves 
system performance. On the other hand, depending on the mainframe type, 
the size of the jobs being rolled out, and the secondary rollout sector 
threshold (EPRDECK and DSD SRST command), CPU overhead may 
increase significantly. Using central memory for pseudo-control points 
instead of using the same memory as UEM for secondary rollout is normally 
preferable because of reduced CPU overhead. Use the ACPD and PROBE 
utilities (refer to TRACER/PROBE Utilities, section 21) to determine the 
best use of system resources. 



14. Routing a file to queues changes a file's type, not its residency. Thus specifying an MSAL.I=est or MSAL.Oest entry does 
not necessarily force all input or output queued files to the specified devices. 
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Secondary rollout files are rollout files whose size in sectors is smaller than a threshold 
specified by the IPRDECK or DSD entry SRST. These files are rolled out to devices specified 
by the MSAL,S= entry. All files selected for rollout that are equal to or greater in size than 
the threshold are rolled out to devices specified by the MSAL,R= entry. The default value of 
SRST is (zero); thus, no secondary rollout files exist unless this value is changed. A 
possible use of this feature is: 

Entries Comments 

EQPDECK 

eq5=dp, st=on, sz=iooo , ch=27 . Specify equipment 5 as extended memory with a DDP. 
msal , s=5 . Direct secondary rollout files to extended memory. 

IPRDECK 

srst=20 Set threshold count so that no large rollout files are 

rolled out to extended memory. 
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DOWN — Down Channel Entry 

The DOWN entry disables the use of channels at deadstart before the system attempts to 
use them to access devices connected to them. If a channel is the only remaining access to a 
device, it may not be downed unless that device is defined as DOWN. The DOWN entry does 
not apply to either the deadstart channel or the CIP channel. 

The DOWN entry format is: 

DOWN,CH=ch 1 ,ch 2 , chjj. 

Parameter Description 



chj Number of the channel; from to 13 8 and 20 8 to 33 8 . A concurrent channel 

is indicated by a C prefix (Cchi). 

Example: 

The following entry sets DOWN status for both nonconcurrent channel 23 
and concurrent channel 4. 

DOWN,CH=23,C4. 

UP — Up Channel Entry 

The UP entry allows resumption of normal use of channels that have been disabled by a 
previous DOWN entry. 

The UP entry format is: 

UP,CH=ch 1 ,ch 2 , . . . -chjj. 

Parameter Description 



chj Number of the channel; from to 13 8 and 20 8 to 33 8 . A concurrent channel 

is indicated by a C prefix (Cchi). 

Example: 

The following entry clears DOWN status of both nonconcurrent channel 23 
and concurrent channel 4. 

UP,CH=23,C4. 
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PF — Permanent Files Device Assignment Entry 

Before initializing a mass storage device (with the INITIALIZE entry in the EQPDECK), 
add a PF entry 15 for that device to the EQPDECK anywhere after the device's EQ entry. 
The PF entry information becomes part of the device's label when it is initialized during 
deadstart; this label is recovered during subsequent deadstarts. For subsequent deadstarts, 
it is not necessary that the PF entry be part of the EQPDECK on the deadstart file; if it is, 
it is ignored. Refer to the INITIALIZE entry for the default PF entries. 

If the unit is a family device, the format is: 

PF=est , type , dm, sm, name , device , nc . 
If the unit is an auxiliary device, the format is: 

PF=est , type , name , nc . 

Parameter Description 

est EST ordinal of the device; from 5 to 777 8 . 

type Type of device; one of these values: 

type Description 

F Family device. It can contain indirect access files if the dm 

parameter is from 1 to 377 8 . It can contain direct access files if the 
sm parameter is from 1 to 377 8 . It is a master device if the dm 
parameter is specified. 

X Auxiliary device, which can contain both direct and indirect access 

files. X must be specified on a unit's PF entry if any of the 
auxiliary device commands are to be used for the device. 

dm Specifies the unit's device mask; from to 377 8 . Set according to information 

under Device Masks in section 17, PF Utilities. Omit this parameter if the 
device is an auxiliary device. 

The device mask for a permanent file device defines the groups of users 
whose catalogs reside on the device for a particular family. 

sm Specifies the unit's secondary mask; from to 377 8 . Set according to 

information under Device Masks in section 17, PF Utilities. Omit this 
parameter if the device is an auxiliary device. 

This parameter controls the residence of direct access files in the same way 
that dm controls the residence of indirect access files. 



15. Refer to table 3-5 for dependencies. 
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Table 3-5. PF Entry Parameter Settings (type, dm, name, device, and sm) 



Type of PF 
Device 


Files Permitted on 
Device 




type 


dm 


name 


device 


sm 


Auxiliary 1 


Indirect and/or 




X 


Omit 


pack 


Omit 


Omit 


Family 


direct 
Direct only 




F 





family 


l-77 8 


l-377 8 




Indirect only 




F 


l-377 8 


family 


l-77 8 







(master device) 
Indirect and 




F 


l-377 8 


family 


l-77 8 


l-377 8 




direct (master device) 














1. If the device is to be a private auxiliary device, enter the INITIALIZE command after 
deadstart and specify the user name. Refer to section 8, K-Display Utilities, for the 
procedure. 
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Parameter Description 



name Designates either the name of the family to which the unit belongs or its 

pack name if it is an auxiliary device; from 1 to 7 alphanumeric characters. 
Do not use the family name 0: it is reserved. 

The family name describes the permanent file devices available to a user. 16 
A family may consist of from 1 to 63 logical devices; however, the master 
devices within the family must have device masks totaling 377 8 if all 
possible user indexes are to be accommodated. 

Usually a system runs with one family of permanent file devices available. 
But you can activate additional families on a system, in order to allow the 
users of these families to access their permanent files through an alternate 
system. This might be helpful if one system supplies backup service to 
another system. When more than one family is active on a system, users 
with matching user indexes access the same permanent files on a public 
auxiliary device. You can avoid this situation by predetermining a range of 
user indexes for each family running on a system. When a new family is 
introduced into a system, its user indexes should be checked against those of 
the family or families currently running and any matching indexes should be 
changed. Refer to the IPRDECK entry COMLIB later in this section. 

The pack name is the unique 7-character name associated with an auxiliary 
device. An auxiliary device is a self-contained permanent file device: all 
permanent files (whether direct or indirect access) represented by the 
catalogs on the device reside on that device. To access a file on an auxiliary 
device, users must specify the pack name as part of the permanent file 
request. The pack name is used instead of the usual algorithm for 
determining catalog location (user masks and family name). An auxiliary 
device can be private or public. Any user who knows the pack name and has 
the appropriate permissions and validations can access files on an auxiliary 
device. Only the owner user name can create files on a private auxiliary 
device (perform DEFINE, SAVE, or REPLACE requests). 

device Number of the device in the family; from 1 to 77 8 . Omit this parameter if 

the device is an auxiliary device. 

A permanent file that does not reside on the master device has a device 
number in the catalog entry or on the master device. The device number 
specifies on which alternate device within the family the file resides. 



16. If not otherwise specified, the default family name becomes part of the tape label information. It is checked and verified if the 
user specifies the FA=A parameter on a command. Refer to the NOS Version 2 Reference Set. Volume 3 for a discussion of FA=A. 
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Parameter Description 



nc 



Number of catalog tracks (optional) used only for master devices; from 1 to 
200 8 . This value must be a power of 2. If you do not specify nc, one of the 
following default values (based on the equipment type) is supplied. 



Default nc Equipment 



10 
40 
40 
40 
40 
10 
10 
10 
10 
10 
10 
10 
4 



819 

834 

836 

844-21 

844-41/44 

885-11/12 

885-42 

887(4K) 

887U6K) 

895 

5832/5833/5838 

9853 

Extended 
memory 

ECS or ESM 
with DDP 

Private device 



Type 



DV/DW 

DD 

DG 

DI/DK 

DJ/DL 

DM/DQ 

DB 

DF 

DH 

DC 

EA-EH 

DN 

DE 

DP 



Examples: 



PF=6,F, 125, 125, SYSTEM, 3,200. 
PF=17,X,PACK. 
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SYSTEM — System Library Device Assignment Entry 

The SYSTEM entry specifies which mass storage devices are to contain copies of the NOS 
system library from the deadstart file. A system device can be any disk storage device as 
well as extended memory. 

Throughput can be greatly improved by specifying more than one system device. For 
example, if two system devices are specified and they are on different channels, the time 
required to access system programs can be reduced. When the channel for one system 
device is busy, the other is accessed. Also, if hardware problems occur on one system device, 
the other system device can still be accessed. A good general rule is to have one copy of the 
NOS system library per pair of channels with a maximum of three copies. This allows 
alternate access to the system library while saving mass storage space. 

The following restrictions apply. 

• The EQ entry for a system device cannot have the status set to OFF. 

• A REMOVE entry cannot exist in the EQPDECK for a device being specified as a 
system device. 

• If more than one device is specified as a system device, all devices specified must be of 
the same type and have the same number of spindles. For example, if there are two 
system devices and the equipment EST ordinal for one of them specifies DI (single 
spindle), the equipment EST ordinal for the other one must also specify DI (single 
spindle). 

• If no devices are specified as system devices, the system library resides on the first 
nonremovable mass storage device. 

• An ASR entry cannot exist in the EQPDECK for a device being specified as a system 
device. 

The SYSTEM entry format is: 

SYSTEM=est 1 ,est 2 , ,est n . 

Parameter Description 

estj EST ordinal of the device to contain a copy of the system library on the 

deadstart file; from 5 to 37 8 . The EQ entry must be set to ON status. One 
or more ordinals can be specified with one SYSTEM entry. Ranges of 
ordinals can be specified. The maximum number of system devices allowed 
depends upon the value of MXSY (refer to COMSMSC Parameters in the 
NOS Version 2 Installation Handbook). 
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ASR — Alternate System Library Device Assignment Entry 

This entry specifies which mass storage devices are to be alternate system devices. An 
alternate system device is a mass storage device on which duplicate copies of system 
routines can be placed by the system, either for faster access than is possible from a system 
device or because they are frequently used programs. The following restrictions apply. 

• The device must be a mass storage device, including extended memory. 

• The device cannot be a removable device. 

• The device cannot be a system device. 

When loading a system routine, the system will access the routine from the alternate system 
device if practical. However, if the alternate system device is down or its access is more 
congested than the system device, the system will access the routine from the system device. 

The procedure for selecting the records to be placed on the alternate device is in LIBDECK 

The ASR entry format is: 

ASR=est 1 , est 2 / - • • < est n - 

Parameter Description ^ 



est- EST ordinal of mass storage device to be used as an alternative system 

device; from 5 to 37 8 . Ranges of ordinals can be specified. 



SCKP — System Checkpoint File Device Assignment Entry 

The SCKP entry specifies on which mass storage devices the checkpoint file is to reside. 
This entry is processed during a level 0, 1, or 2 deadstart. If no checkpoint devices are 
defined, the checkpoint file will reside on the first default mass storage device. 

A level deadstart clears the checkpoint status on all mass storage devices. To clear the 
checkpoint status for a specific mass storage device, use the RESET entry. 

The SCKP entry format is: 

SCKP=est 1 ,est 2 , . . . , est n . 

Parameter Description 



estj EST ordinal of the mass storage device to be defined as a system checkpoint 

file device; from 5 to 777 8 . Ranges of ordinals can be specified. 
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FAMILY — Default Family Name Assignment Entry 

The FAMILY entry defines the default family. The family that is to be defined as the 
default family may reside on more than one device. The EST ordinal of any device within 
the family can be specified on the FAMILY entry, except in the following situation. If the 
member of the family whose device mask will have bit 2 7 (200 8 in mask) set is being 
initialized, the FAMILY entry must specify the ordinal of this device. In all cases, the 
FAMILY entry must follow the EQ entry for the device specified. 

The following restrictions apply. 

• The status parameter for a default family device's EQ entry cannot be set to OFF. 

• A REMOVE entry cannot exist in the EQPDECK for a device being specified as a 
default family device. 

The FAMILY entry format is: 

FAMILY=est. 

Parameter Description 

est EST ordinal number of the mass storage device that the system 

automatically uses to determine your family when you do not specify a 
family name at login or job initiation; from 5 to 777 8 . 



REMOVE — Removable Device Assignment Entry 

If a mass storage device is to be considered removable, you must specify it as such at 
deadstart with the REMOVE entry. This allows it to be introduced or removed during 
system operation. A device specified as removable cannot also have associated with it an 
ASR, SYSTEM, MSAL, FAMILY, DAYFILE, ACCOUNT, ERRLOG, or MAINLOG entry 
(refer to Dayfile Descriptions earlier in this section for the last four entries). 

The format is: 

REMOVE=es.t 1 ,est 2 , — ,est n . 

Parameter Description 

estj EST ordinal of mass storage device that is to be removable; from 5 to 777 8 . 

One or more ordinals may be specified with one REMOVE entry. Ranges of 
ordinals can be specified. 
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SHARE — Shared Device Entry 

This entry identifies the rotating mass storage devices to be shared through a link device 
(ECS, ESM, or STORNET) by from two to four mainframes in a multimainframe complex. 
The tables necessary for the management of these devices (MST, TRT, MRT, and DAT) are 
maintained on the link device. The presence of the SHARE entry implies a multimainframe 
complex; shared status will be set for the link device. If the link device is the only device to 
be shared, it must be specified in the SHARE entry. If the SHARE entry is specified, the 
ISHARE entry must be omitted. Refer to PRESET - Preset the Link Device Entry later in 
this section. 

Following is a list of the equipment types that can be shared. 



Equipment 



Type 



ECS without DDP or 
ESM without LSP 


DE 


ECS with DDP or 

ESM with low-speed port (LSP) or 

STORNET 


DP 


844-21 


DI/DK 


844-41/44 


DJ/DL 


885-11/12 


DMDQ 


5830 Disk Array Subsystem 


EA, EB, EC, ED, EE, EF, EG, and EH 



The format of SHARE is: 

SHARE=est lr est 2 , . . - , est n . 

Parameter Description 



estj 



EST ordinal of the mass storage device being shared; from 5 to 777 8 (EST 
ordinal 5 is reserved for the link device). Ranges of ordinals can be specified. 



Refer to section 13, Multimainframe Operations, for suggestions on shared device 
configurations. 
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MAXSHARE — Maximum Shared Device Entry 

This entry defines the maximum number of shared devices in a linked multimainframe 
complex. This number is needed to determine the size of the tables to be allocated in 
extended memory when a PRESET is performed. 

The MAXSHARE entry is only required if some shared devices are not configured in the 
EQPDECK for all the mainframes in the complex. If this entry is not specified, the default 
is the number of shared devices configured on this mainframe, as specified by the SHARE 
entry. 

The format for the MAXSHARE entry is the following: 

MAXSHARE=n,b. 

Parameter Description 

n The total number of devices to be shared by any of the mainframes in the 

complex. 

b The total number of buffered devices to be shared by any of the mainframes 

in the complex. This parameter is optional. 
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ISHARE — Independent Shared Device Entry 

This entry identifies the rotating mass storage devices that are to be independently shared 
by from 2 to 16 mainframes in a multimainframe complex. The tables necessary for the 
management of these devices (MST, TRT, MET, and DIT) are maintained on the shared 
device. You cannot designate ECS or ESM in an ISHARE entry. When the ISHAEE entry is 
specified, the SHARE entry must be omitted. Refer to PRESET - Preset the Independent 
Shared Device Entry later in this section. 

Listed are the equipment types that can be independent shared devices. 
Equipment Type 



834 


DD 


836 


DG 


844-21 


DI/DK 


844-41/44 


DJ/DL 


885-11/12 


DM/DQ 



The ISHARE entry format is: 

ISHARE=est 1 , est 2 , . - - , est n 

Parameter Description _____ 

est; EST ordinal of the mass storage device being shared; from 5 to 777 8 . Ranges 

of ordinals can be specified, as described under Specifying Ranges of EST 

Ordinals earlier in this section. 

Refer to section 13, Multimainframe Operations, for suggestions on shared device 
configurations. 
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LBC — Load Buffer Controllers Entry 

This entry identifies the type of controlware to be installed on the specified disk channels. 
Depending on the specified parameters, this entry can identify the channels as having 
half-track or full-track controlware but not install the controlware. 

Unless you specify the LBC entry, the system examines the mnemonics of the device in the 
EQPDECK entry and causes the default version of controlware to be installed as follows: 

Controlware Version Number 



Device 


Contra 


Type 




DBl? 


MA722 


DC 18 


MA464 


DD 19 


MA462 


DG 18 


MA462 


DI 


MA710 


DJ 


MA710 


DK 


MA401 


DL 


MA401 


DM 


MA721 


DQ 


MA721 



Use the LBC entry to override these defaults. The LBC entry format is: 

LBC, type, c-pCj, . . .,c n . 

Parameter Description 

type Controlware to be installed; one of these values. 

type Description 



CC Install 7165 controller with full-track (MA464) controlware. 

CN Identify channel(s) as having full-track 7165 controller, but do not 

install the controlware. 

FM Install controller with full-track (MA721) controlware. 

FT Install controller with full-track (MA401) controlware. 



17. Not applicable for CYBER 180-class machines. 

18. Applicable for CYBER 180-class machines except models 810, 815, 825, and 830. 

19. Applicable for models 810, 815, 825. and 830 only. 
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Parameter Description 



type 


(Continued) 




type 

HT 


Description 




Install controller with half-track (MA710) controlware. 




ID 


Install 7255-1 adapter with full-track (MA462) controlware. 




M8 


Install 7990 controller with MB466 controlware. 




NF 


Identify channel(s) as having full-track controller, but do not 
install the controlware. 




NH 


Identify channel(s) as having half-track controller, but do not 
install the controlware. 




NI 


Identify channel(s) as having full-track 7255-1 adapter, but do not 
install controlware. 




NM 


Identify channel(s) as having full-track 7155-1 controller, but do 
not install the controlware. 




NN 


Identify channel(s) as having NADs, but do not install the 
controlware. 




NP 


Identify channeKs) as having 7155-401 controller, but do not install 
the controlware. 




NX 


Identify channel(s) as having 5870 printer, but do not install the 
controlware. 




N8 


Identify channel(s) as having 7990 controller, but do not install the 
controlware. 




PH 


Install 7155-401 controller with MA722 controlware. 


c i 


Disk ch 


annels; type determines if controlware is installed on these channels. 
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The controlware version number that can be loaded into the adapter or controller types is: 

Adapter 

Controller Controlware Version Number 



7054 


MA710 


7152 


MA710, MA401 


7154 


MA710, MA401 


7155-1 


MA721 


7155-401 


MA722 


7165 


MA464 


7255-1 


MA462 


7990 


MB466 



XM — Declare Extended Memory Space for Buffers or User Access 

The XM entry reserves space for I/O buffers and causes initialization of tables for user 
access to extended memory. 

NOTE 

Except on models 865 and 875, the assignment of user access to extended memory forces 
jobs using user access to use CPU 0. This prevents CPUMTR from being locked out during 
large block transfers to or from extended memory on dual-CPU mainframes. 

The XM entry is required if the system contains user-accessible extended memory or 
buffered devices. If UEM is to be used only for user-accessible extended memory, you do not 
need to specify an extended memory EST entry in the EQPDECK To access UEM, it must 
be enabled (refer to the USER EXTENDED MEMORY IPRDECK entry later in this section). 
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The XM entry format is: 

XM=id, iob , uec , EM. 

Parameter Description 



id Identifier of the mainframe that will access the reserved extended memory 

space; id is required. 

If an XM entry refers to shared extended memory (ECS or ESM as a link 
device), the XM entry must be present in the EQPDECKs of all linked 
mainframes. If an XM entry refers to nonshared extended memory (UEM), 
the XM entry must be present only in the EQPDECK for its own mainframe. 

iob Number of words/1000 8 reserved for buffers for DB, DC, DF, DH, DN, DV, or 

DW devices; from 40 8 to 37770 8 . This value is limited by the amount of 
memory available; either physically present or logically available (allocated 
in the CMRDECK and EQPDECK entries). The optimum number of words 
to reserve is the amount left after the alternate system library and 
user-accessible extended memory are taken into account. If no buffered 
devices are defined, enter 0. 

uec Number of words/1000 8 of extended memory to reserve for user access; 

maximum value is 77740 8 . This value is limited by the amount of memory 
available; either physically present or logically available (allocated in the 
CMKDECK and EQPDECK entries). 

EM For models 865 and 875 and CYBER 180-class machines, user-accessible 

extended memory can be allocated in UEM without allocating UEM as an 
equipment. If you want only user-accessible extended memory in UEM, clear 
or do not specify an extended memory EST entry in the EQPDECK and 
enter XM with the uec size and the EM keyword. 

For models 865 and 875, if you specify EM, user-accessible extended memory 
is allocated in UEM regardless of the presence of ECS or ESM; if you omit 
EM, user-accessible extended memory is allocated in the device defined in 
the extended memory EST entry. 

UEMIN — UEM Equipment Initialization 

The UEMIN entry enables full initialization for UEM equipment during a level deadstart. 
It is equivalent to an INITIALIZE ,AL,est entry. The UEMIN entry can be included as part 
of the EQPDECK on the deadstart file or it can be entered from the system console at 
deadstart time. If the UEMIN entry is being used, the EQ entry for the DE equipment is 
required. If you enter UEMIN when it's already set, it disables the automatic initialization 
of UEM. The UEMIN format is: 

UEMIN. 
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ACCESS — Set Access Level Limits 

The ACCESS entry allows you to specify equipment access level limits for mass storage, 
magnetic tape, two-port multiplexer, stimulator multiplexer, and unit record type 
equipment. This entry is invalid for other types of equipment. This entry determines the 
upper and lower limits for the range of access levels of the data allowed to be read from or 
written to the equipment. The default equipment access level limits are zero; no secure data 
can be read from or written on the equipment. Values for this entry should be supplied by a 
site security administrator. 

If you want the equipment access level limits specified by this entry to become the device 
access level limits for mass storage equipment, that equipment must be initialized. Refer to 
the NOS Version 2 Security Administrator's Handbook for more information about 
equipment access and device access level limits. 

This entry is ignored if the system is running in unsecured mode. 

The format of the ACCESS entry is: 

ACCESS , lower , upper , ordlist . 

Parameter Description 

lower Access level name specified in deck COMSMLS (refer to the NOS Version 2 

Installation Handbook) corresponding to the desired lower limit. 

upper Access level name specified in deck COMSMLS corresponding to the desired 

upper limit. 

ordlist One or more EST ordinals, separated by commas, or a range of ordinals as 

described in Specifying Ranges of EST Ordinals earlier in this section. 
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THRESHOLD — Set Disk Thresholds 

The THRESHOLD entry enables you to set threshold values for the disk storage devices 
specified by EST ordinals. The system uses these threshold values as limits when 
monitoring disk verification failures, available disk space, and disk error processing. If a 
threshold value is exceeded, the system performs a corrective action, such as notifying the 
operator or restricting activity on the affected disk. The format of the THRESHOLD entry is: 

THRESHOLD, type=value , ordlist . 



Parameter Description 



type You can specify one of the following threshold types. Refer to the DSD 

THRESHOLD command in section 5 for additional information. 



type Description 

VF 
RA 
LS 
RE 
UE 



Verification failure threshold (default). 
Restricted activity threshold. 
Low space threshold. 
Recovered error threshold. 
Unrecovered error threshold. 



value 



The threshold value can range from to 3777 8 . If the value parameter is 
omitted, the following default values are used. 



type 



value 



VF 

RA 1/8 of the number of tracks on the device. 

LS 1/16 of the number of tracks on the device. 

RE 50 8 

UE 

ordlist Enter one or more EST ordinals, separated by commas, or a range of ordinals 

as described in Specifying Ranges of EST Ordinals earlier in this section. 



60459300 U 



Deadstart Decks 3-95 



EQPDECK 



EQPDECK Entries Made Only During Deadstart 

The following entries are valid only from the system console at deadstart time. They cannot 
be included as part of the EQPDECK on the deadstart file. 



AUTOLOAD — Toggle Autoloading 

The AUTOLOAD entry toggles the selection of buffer controller autoloading for all 
7054/7154/7152/7155/7165 controllers and the 7255 adapter. The AUTOLOAD format is: 

AUTOLOAD. 



GRENADE — Clear Unit Reservations 

The GRENADE entry causes unit reservations to be cleared on all 844 units physically 
connected to each 7054/7154/7152/7155 controller and any 834 or 836 units connected to a 
7255 adapter. The GRENADE format is: 

GRENADE. 



INITIALIZE — Initialization Entry 

To use a mass storage device that is denned with an EQ entry, it must have a label. A label 
is written on a device when you initialize it by using either the INITIALIZE command, 
during system operation, or the INITIALIZE entry in the EQPDECK, when it is displayed 
at the system console at deadstart time. 

A mass storage device's label is contained on a logical track (usually track 0). It contains 
information about the allocation and characteristics of a device (and its units, if there is 
more than one unit on a device). This information is in the form of a label sector for the 
first unit, a TRT for the device, and a label sector for each unit. 

Initialization does not automatically occur at each deadstart because mass storage device 
labels are recovered during all deadstarts. Therefore, initialize a device only in the 
following situations. 

• To add a new mass storage device (no label exists on the device) use the INITIALIZE 
entry. 

• If parts of the label on a permanent file device have been destroyed by maintenance 
operations (permanent files having been dumped to another device before diagnostics 
were run), use the INITIALIZE entry during deadstart to write a new label. Then 
reload the permanent files. 

• If a device (usually a private auxiliary, public auxiliary, or alternate permanent file 
family device) is added to a system during operation, use the DSD INITIALIZE 
command to initialize it if it does not have a valid label on it when it is added to the 
system. 

• When an extended memory device is initially placed in maintenance mode, all 
mainframes using extended memory must initialize it (the maintenance mode 
parameter is described under EQ - Extended Memory EST Entry earlier in this 
section). You must also enter the PRESET entry for multimainframe operation. 
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During a deadstart, the INITIALIZE entry has the following characteristics. 

• During a level deadstart, it can be entered at the system console only when the 
EQPDECK is displayed. It can be entered anywhere after the EQ entry for the device. 

If it is placed in the deadstart file EQPDECK, the system issues the error message 
INCORRECT ENTRY when the EQPDECK is read from the tape. 

• A total initialization (op=AL) assumes that no valuable information exists on the device 
and creates a new label. When the new label is created, all previously existing 
information on the device, except CTI, CDA, HIVS, and MSL, is lost. 

• If the EQ status for the device is OFF when INITIALIZE is entered, initialization of the 
device occurs whenever the device is set to ON status by the operator with the DSD ON 
command during normal system operation. 

• If the device is not a master device, INITIALIZE (op=AL) only writes a label; if it is a 
master device, then it also initializes the catalog track and writes EOIs at the beg in ni n g 
of the permit track, the indirect access track (data chain), and each catalog track. 

• During a deadstart initialization (op=AL), all flaw reservations specified for a device are 
lost and must be reentered, except for 844 type devices with factory-formatted disk 
packs. 

• During an initialize format pack (op=FP) for an 895 disk, NOS only formats those 
cylinders it plans to use in large record format. NOS does not format the disk cylinders 
occupied by CIP. 

• During an initialize format pack (OP=FP) for a 583x device, the system first checks the 
current format of the device. If the device is formatted correctly, the system reformats 
the device only if FORCED FORMATTING is enabled. FORCED FORMATTING is 
enabled by default. To disable FORCED FORMATTING, enter the DISABLE, FORCED 
FORMATTING command either in the IPRDECK or from DSD. 



NOTE 



If a disk deadstart is in progress, the deadstart disk cannot be initialized. An attempt 
to initialize it will result in the system issuing the error message INCORRECT ENTRY. 



The format of INITIALIZE is: 

INITIALIZE, op, est 1( est 2 , . . -,est n 

Parameter Description 



op Level of initialization; one of these values: 



op Description 



AF Initialize account dayfile. 

AL Total initialization. For an 895 disk, the AL parameter is equivalent 

to the FP parameter if an initial install of CIP was done or if CIP 

was released. 
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Parameter Description 



op (Continued) 



op Description 



DF Initialize system dayfile. 

EF Initialize error log. 

FP Initialize format pack (an automatic selection of AL also occurs). 

This option applies to 844, 895, and 583x disks only. 

MF Initialize binary maintenance log. 
PF Initialize permanent files. 

QF Initialize queued files. 

estj EST ordinal of mass storage device to be initialized; from 5 to 777 8 . 

If the ordinal refers to a family permanent file device, then family name, 
device number, and mask (if it is a master device) are specified on the PF 
entry. 

If it is an auxiliary device, the pack name is specified on the PF entry. 

Total initialization (op=AL or FP) is the only initialization that is independent of the 
content of the pack, if the initialization occurs during deadstart. If the initialization is done 
while the system is ninning, it is applied to the device after the check mass storage (CMS) 
routine has recovered it. If CMS cannot recover the device, the initialization is similar to a 
deadstart initialization (that is, all information on the device is lost). 

The device number, family name, and device masks can only be changed during a total 
initialization. Since all devices may contain permanent files, you should include a PF entry 
for a device when performing a total initialization. If you do not, the device is assigned a 
default family name, device number, and device masks. It is possible that these parameters 
may conflict with other devices in the system. If a conflict occurs, resolve it by using PF 
entries. 

If you initialize a nonremovable device without a PF entry, the device mask and secondary 
mask default to 377 8 for the smallest EST ordinal larger than 5. For all other equipment, 
including equipment 5, the default masks are set to (zero). The default family name is 
SYSTid (where id is the machine identifier). The default device numbers begin at 1 and 
increase by 1 (starting with EST ordinal 5) for each device that you initialize without a PF 
entry. 

The INITIALIZE entry operates in conjunction with the dayfile entries DAYFILE, 
ACCOUNT, ERRLOG, and MAINLOG (refer to Dayfile Descriptions earlier in this section) 
to determine where the dayfiles actually reside. The following examples illustrate the 
various cases. Assume that the system has three mass storage devices (EST ordinals 6, 7, 
and 10). 
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Example 1: 

For this example, no dayfile entries are made and no previous dayfiles exist. 

The following EQPDECK entry is made. 

INITIALIZE, AL, 6, 7, 10. 

All dayfiles reside on ordinal 6. 

Example 2: 

In this example dayfile entries are made, but no previous dayfiles exist. 

The following EQPDECK entries are made. 

DAYFILE=6,200. 
ACCOUNT=7,200. 
ERKLOG=10. 
MAINLOG=10,200. 
INITIALIZE, AL, 6, 7, 10 . 

In this case, the dayfiles reside on the indicated devices (system dayfile on ordinal 6, 
account dayfile on ordinal 7, error log and binary maintenance log on ordinal 10). The 
default buffer length is used for the error log buffer. 

Example 3: 

In this example, dayfile entries are made and previous dayfiles do exist. 

Assume that the EQPDECK entries in example 2 are used. 

Since a total initialization has been done on each device, no dayfiles are recovered. They 
reside on the indicated devices. 

Example 4: 

In this example, dayfile entries are made, previous dayfiles exist, but no dayfile 
initialization entries are made. 

The following EQPDECK entries are made. 

DAYFILE=6. 
ACCOUNT=7 . 
ERKLOG=10. 
INITIALIZE, PF, 6. 

The dayfiles may already reside on the specified devices, or they may reside on some 
combination of the possible devices. In either case, since no dayfile initialization entries are 
made, the old dayfiles are recovered. The residence of these dayfiles is governed by the 
residence of the old dayfiles. The PF initialization entry returns all permanent file space 
and relabels the device based on the recovered device parameters. The dayfiles and queued 
files on this device are not affected by this entry. 
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Example 5: 

In this example, dayfile entries are made, previous dayfiles exist, no dayfile initialization 
entries are made, and duplicate dayfiles are in existence. 

Assume that the EQPDECK entries in example 4 are used. 

For the dayfiles that do not have duplicates, the residence is denned by the current 
residence of the files, not the EQPDECK entries. But assume that an error log is recovered 
from ordinals 6 and 10. In this case, the most recent file becomes the active error log. Its 
previous residence overrides the EQPDECK entry. The other file becomes an inactive error 
log (an entry exists in the mass storage table of the device pointing to the inactive file, but 
the file is not in use by the system). 

To produce an inactive error log, the site must run in the following manner. 

1. Assume an 844 disk subsystem with two or more spindles is being used. Run with unit 
1 equated to EQ6 and unit unused. 

2. Redeadstart, equate unit to EQ6, and do not use unit 1. 

3. Redeadstart, equate unit to EQ6, and unit 1 to EQ7. 

Since unit has the most recent copy of the error log, this copy would become an active 
error log and the copy on unit 1 would become an inactive error log. 

Example 6: 

In this example, dayfile entries are made, the previous dayfiles from example 2 exist, and 
initialization entries are made. 

The following EQPDECK entries are made. 

DAYFILE=7 . 
ACCOUNT=7 . 
ERRLOG=lO,300. 
MAINLOG=10 . 
INITIALIZE, DF, 6. 
INITIALIZE, QF, 6. 

In this case, the account dayfile is recovered and continued on ordinal 7. The binary 
maintenance log is recovered and continued on ordinal 10 with a CM buffer length of 100. 
The error log is recovered and continued on ordinal 10 with a CM buffer of 300 8 words. The 
system dayfile space on ordinal 6 (from example 2) is released and the new system dayfile 
starts on ordinal 7. The QF initialization entry releases all space reserved by queued files 
on ordinal 6. 

The CM buffer length is not affected by dayfile recovery. It is always specified by the values 
defined in the EQPDECK entries. If no buffer length entries exist, the system default 
values are used. 
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PRESET — Preset the Link Device Entry 

This entry defines allocation space and initializes the tables (MST, TRT, MRT, BAT, BRT, 
and BDT) on the link device that are required for management of shared multimainframe 
mass storage devices. The entry is valid only for level deadstarts by the first mainframe 
in the multimainframe complex to deadstart. 

Once PRESET is issued, the SHARE entry is disabled. Therefore, all SHARE entries must 
precede the PRESET entry. The PRESET entry has the format: 

PRESET . 
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PRESET — Preset the Independent Shared Device Entry 

This entry presets the independent shared devices in a multimainframe complex. The MST, 
TRT, MRT, and DIT are maintained on the mass storage device itself and are not affected 
by the PRESET entry. This entry is used in conjunction with the ISHARE entry. It is valid 
only on a level deadstart by the first mainframe in the multimainframe complex to 
deadstart. All ISHARE entries must precede the PRESET entry. 

The format is: 

PRESET=est 1 ,est 2 , ...,est n . 
Parameter Description 



est; EST ordinal of the ISHARE device; from 5 to 777 8 . Ranges of ordinals can be 

specified, as described under Specifying Ranges of EST Ordinals earlier in 
this section. 

Refer to section 13, Multimainframe Operations, for suggestions on shared device 
configurations. 

WARNING 



If a PRESET is entered for a device that is already in use by a second machine in a 
multimainframe complex, system failures may occur on both machines, and data on the 
device may be destroyed. 

If a PRESET is entered for a device while a second machine in a multimainframe complex is 
down, and if that second machine later attempts to perform a level 3 deadstart and use that 
device, system failures may occur on both machines, and data on the device may be 
destroyed. 



RESET — Reset Device Attributes 

The RESET entry rescinds all device-related attributes resulting from entries such as 
REMOVE, SYSTEM, MSAL, and so on. It restores the values specified with the last EQest 
entry encountered. The format is: 

RESET=est 1 , est 2 , . . . , est n . 

Ranges of ordinals are not allowed; each ordinal must be entered individually. 
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APRDECK 

The auxiliary mass storage parameter deck (APRDECK) is a text record on the deadstart 
file that is processed during system initialization. APRDECK entries identify areas of mass 
storage that are unusable (flawed areas) and prevent the system from accessing them. The 
system uses the information in the APRDECK entries to build the TRT for each device that 
resides in CMR and also in the mass storage device label. 

You can place up to 64 APRDECKs on the deadstart file. Placing several APRDECKs on the 
same deadstart file allows you to use the same file to deadstart several configurations. 

APRDECK Format 

The first line in an APRDECK is the deck name. The format of the APRDECK name is: 

APRDnn 

Parameter Descriptioii 

rm Number identifying the APRDECK; from 00 to 77 8 . 



An APRDECK must have a name and may have flaw entries. The first APRDECK must 
contain the deck name APRD00 and nothing else. Subsequent APRDECKs must be 
numbered consecutively and can contain flaw entries. 

The released version of the APRDECK contains no entries. You can enter flaws at three 
different times: 

• During deadstart, after entering all EQPDECK modifications. 

• During system operation, using the FLAW entry (refer to section 8, K-Display Utilities). 

• During the configuration of a deadstart file. 

If during deadstart you initialize a device and then enter NEXT, the system displays both 
the parameters on the device's EST entry and the APRDECK referenced by the EST entry. 
You can then change the flaws for the device. If the first APRDECK is referenced by the 
EST entry, the system displays the parameters on the device's EST entry and the 
APRDECK name, APRD00. You can then enter flaws for the device. These changes to the 
APRDECKs remain in effect until the next deadstart. 

For example, in a EQPDECK, the EST entry for an 844-21 disk is: 

EQ07=DI,ST=ON,EQ=0,CH=31/33,AP=5,UN=2. 

After you initialize equipment 07 and enter NEXT, the following display appears. 



EQ TYPE 


ST 


EQ 


ONITS 


CHA 


nne: 


07 DI-1 


ON 





02 


31 


33 


APRD05 












SLF=4173 . 












SLF=7062. 
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The APRDECK entries described in this section are those to be used for entering flaws 
during deadstart or during the configuration of the deadstart file. Use the entries as follows. 

Use the CAF entry to clear all flaw reservations on a device. 

Use the SPF entry to specify the physical address of a flaw in extended memory. (If a 
reservation for that physical address already exists, it remains in effect.) 

Use the SPF entry to specify the cylinder, track, and sector of a flaw in a disk. (If a 
reservation for that physical area already exists, it remains in effect.) 

Use the CPF entry to cancel a particular SPF entry. 

Use the SLF entry to specify the logical address of a flaw. (If a reservation for that 
logical address already exists, it remains in effect.) 

Use the CLF entry to cancel an SLF entry. 

NOTE 

All numeric values entered in the APRDECK must be entered in octal. 



Either obtain flaw addresses from a customer engineer, or run the MST (mass storage test) 
on the device to determine the bad areas. MST specifies the physical address of flaws. 

The system reads the flaw information recorded on the utility flaw map of an 881/883/885 
disk pack during the initialization of 844/885 equipment and reserves the appropriate areas. 
For multiunit devices, the flaw reservation is the union of all utility flaw maps. This 
automatic flawing process occurs in addition to any APRDECK entries. However, you 
cannot clear areas recorded as flawed on the utility flaw map of an 881/883/885 disk pack 
with the CAF entry. Refer to appendix G for information on clearing these flaws. 

You can list all APRDECKs on the deadstart file by accessing the system file SYSTEM with 
an ASSIGN or COMMON command, then using the T parameter on the CATALOG 
command. Refer to the NOS Version 2 Reference Set, Volume 3 for more information. 

CAF — Clear All Flaw Reservations 

The CAF entry clears all flaw reservations previously made with SLF or SPF entries. The 
format is: 

CAF. 
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SLF — Set Logical Flaws on Any Mass Storage Device 

Use this entry to specify the logical address of a flaw. If the track was previously reserved, 
that reservation remains in effect. The format is: 

SLF=track. 

Parameter Description 



track Logical track number. Refer to table 3-6 for valid ranges of track numbers. 

CLF — Clear Logical Flaws on Any Mass Storage Device 

To cancel a reservation made with an SLF entry, enter the identical track number using the 
CLF entry. The format is: 

CLF=track. 
Parameter Description ^ 



track Logical track number. Refer to table 3-6 for valid ranges of track numbers. 

SPF — Set Physical Extended Memory Track or Disk Area Flaws 

Two formats exist for the SPF entry. One format prevents the system from using blocks 
(tracks) of extended memory. The other format prevents the system from using sectors on 
disks. 

Use the following SPF format to prevent the system from using blocks (tracks) of extended 
memory. 

SPF=Aaddress . 

or 

SPF=Aaddress 1 -Aaddress 2 . 

Parameter Description 



Aaddress The 1- to 7-digit octal logical address in a track of extended memory; track 
containing the absolute address is reserved. The letter A must precede the 
address. 

Aaddress! Lowest (Aaddress!) and highest (Aaddress 2 ) addresses in a range of logical 
Aaddress 2 addresses in one or more tracks of extended memory. All tracks in the range 

are reserved. The letter A must precede the addresses; the hyphen is 

required. 

Use the following SPF format to prevent the system from using sectors on disks. 

SPF=Ccylinder , Ttrack , Ssector . 
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Refer to table 3-6 for the number of cylinders, tracks, and sectors for each device. 

Parameter Description 

Ccylinder Cylinder number; the letter C must precede the number. 
Ttrack Track number; the letter T must precede the number. 

Ssector Sector number; the letter S must precede the number. 

CPF — Clear Physical Extended Memory Track or Disk Area Flaws 

To cancel a reservation made with an SPF entry, enter the identical information with a CPF 
entry. The format is the same as for the SPF entries. 

Table 3-6. Information for Setting or Clearing Flaw Areas 







Logical 










Device 


Track 


Cylinders/ 


Tracks/ 


Sectors/ 


Device 


Type 


Range 1 


Device 1 


Cylinder 1 


Track 1 


819, single density 


DV 


4000-5465 


633 


12 


24 


819, double density 


DW 


4000-7153 


1466 


12 


24 


834 


DD 


4000-7135 


1457 


12 


40 


836 


DG 


4000-6565 


1273 


30 


57 


844-21, halftrack 


DI 


4000-7137 


630 


22 


30 


844-21, full track 


DK 


4000-7137 


630 


23 


30 


844-41/44, halftrack 


DJ 


4000-7147 


1464 


23 


30 


844-41/44, full track 


DL 


4000-7147 


1464 


23 


30 


885-11/12, halftrack 


DM 


4000-7221 


1511 


50 


40 


885-11/12, full track 


DQ 


4000-7221 


1511 


50 


40 


885-42 


DB 


4000-7221 


1511 


12 


40 


887, 4K sector 


DF 


4000-7343 


1562 


4 


46 


887, 16K sector 


DH 


4000-7343 


1562 


4 


13 


895 


DC 


4000-7351 


1565 


17 


3 


9853 


DN 


4000-7726 


2601 


23 


25 


Extended memory 


DE/DP 


4000-7620 








5832, IX SSD 


EA 


4000-7745 


1514 


4 


3 


5832, 2X SSD 


EB 


4000-7745 


1514 


4 


6 


5833, IX Sabre 


EC 


4000-7775 


3135 


7 


6 


5833, 1XP Sabre 


ED 


4000-7775 


3135 


7 


6 


5833, 2X Sabre 


EE 


4000-7761 


3135 


7 


13 


5833, 2XP Sabre 


EF 


4000-7761 


3135 


7 


13 


5838, IX Elite 


EG 


4000-7750 


5074 


11 


5 


5838, 1XP Elite 


EH 


4000-7750 


5074 


11 


5 


1. Numbers are in octal. 
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IPRDECK 

The IPRDECK contains the system installation parameters that determine the system's 
operation mode. From 1 to 64 IPRDECKs can exist on a deadstart file. The IPD entry in 
the CMRDECK specifies which IPRDECK to use. If you omit the IPD entry, the system 
uses the first IPRDECK on the deadstart file. IPRDECKs are named IPRDnn, where nn is 
from 00 to 77 8 . 

There are two IPRDECK console displays. The initial display, IPRINST, is an instruction 
display. It gives a brief description of all valid IPRDECK entries. The second display is the 
current IPRDECK If either display overflows two screens, you can page the display. 

You can modify the IPRDECK by entering the appropriate changes or additions from the 
console keyboard. Make these entries while either the IPRINST or IPRDECK is displayed. 
Each console entry supersedes the value currently specified in the IPRDECK 



NOTE 



Changes made to the IPRDECK at deadstart time will be recovered across a level 3 
deadstart; but not across a level 0, level 1, or level 2 deadstart. To make these changes 
permanent, you must create a new deadstart file with these changes incorporated into the 
IPRDECK 



You can list all IPRDECKs on your system by accessing the system file SYSTEM with a 
COMMON command, then using the T parameter on the CATALOG command. Refer to the 
NOS Version 2 Reference Set, Volume 3 for more information concerning these commands. 

Most of the IPRDECK entries are also valid DSD commands that can be used to make 
changes during system operation. Changes to the IPRDECK using DSD commands are 
retained after a level 3 deadstart, but not after a level 0, level 1, or level 2 deadstart. 
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Job Control Information 

The QUEUE, SERVICE, and DELAY entries in the IPRDECK relate to job control. General 
information concerning job control follows. 

Job Scheduling 

Job scheduling is the control of jobs in the input (IN), executing (EX), and output (OT) 
queues for each service class. Scheduling in the input and output queues is based on the 
priority of a queue entry relative to all queue entries in the system. The priority of a queue 
entry depends both upon how long the entry has been waiting in the queue and upon the 
parameters specified on the QUEUE entry in the IPRDECK The following formula shows 
how the system computes the priority; all values are octal. 

(ct-et) 

p = + lp 

wf 

Variable Description __^_^_ 

p Priority; LP < p < UP. LP (a parameter on the QUEUE entry) is the lowest 

priority and UP is the highest priority. 

wf Weighting factor; WF parameter on the QUEUE entry. 

ct Current time in seconds. 

et Time in seconds at which the job entered the queue. 

lp Lowest priority; LP parameter on the QUEUE entry. 

When an input or output queue entry is created, its priority is the lowest priority (LP) for 
its service class. The queue priority of the queue entry increases as time passes. The rate at 
which the priority increases depends upon the weighting factor (WF). The larger the 
weighting factor, the slower the priority increases. (The queue priority of an entry with a 
WF of 10 8 increases eight times slower than an entry with a WF of 1.) The queue priority 
increases either until the queue entry is selected for processing or until the queue priority 
reaches the highest priority (UP). If the queue priority of an entry reaches UP, it remains at 
UP until the entry is selected for processing. If the queue priority is zero, the job or file is 
never selected by the job scheduler and stays in the queue until the operator either enters a 
DROP command or resets the priority to a nonzero number. 

Job scheduling for executing jobs determines how much execution time a job gets. The 
amount of execution time depends both on the job's scheduling priority (which is parameters 
specified on the QUEUE and SERVICE entries in the IPRDECK) and on the scheduling 
priorities of other jobs that may be waiting for execution. 
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When a job in the input queue is selected for execution, it gets an initial priority (IP; a 
parameter on the QUEUE entry) for the execution queue. Scheduling priority increases for 
a job in the execution queue in the same way as in the input and output queues. After the 
job is scheduled to a control point, its scheduling priority does not age; it is set to fixed 
values that are changed only when specific events occur. Initially, the job's scheduling 
priority is set to the upper priority bound for its service class (the value of the UP 
parameter on the QUEUE entry). The job's scheduling priority remains at this fixed value 
until the job exceeds either its control point time slice or its central memory time slice. 

If the job exceeds its control point time slice (the CT parameter on the SERVICE entry), its 
scheduling priority is lowered to the control point slice priority (the CP parameter on the 
SERVICE entry). If the job exceeds its central memory time slice (the CM parameter on the 
SERVICE entry) for the first time, its scheduling priority is lowered to the initial lower 
priority (the IL parameter on the QUEUE entry); if the job exceeds its central memory time 
slice for a second or subsequent time, its scheduling priority is lowered to the lower priority 
bound (the LP parameter on the QUEUE entry). 

Exceeding the CP or CM slice does not, by itself, force a job to roll out. A job remains at a 
control point until the job scheduler determines that it needs this job's control point and/or 
memory for a job with a higher priority. If a job rolls out, either to mass storage or to a 
pseudo-control point, its scheduling priority starts at the current value and begins to age 
upward (in the same fashion as input and output queue files). When the job scheduler again 
selects this job to run at a control point, its scheduling priority is again set to UP. 

For interactive jobs, there is an additional execution queue priority, TP (a parameter on the 
SERVICE entry). It is assigned to the execution queue entry of a job restarting after 
terminal I/O. The value of TP aids response time to program prompts. Also, for interactive 
jobs, the initial priority (IP) has an added significance. In addition to being the priority at 
which jobs are scheduled from the input queue to the execution queue, IP is the priority 
assigned when a terminal command is entered. Using separate TP and IP parameters 
allows the system to give faster responses to users interacting with a job. To achieve this, a 
value for the TP parameter slightly greater than the value for the IP parameter is 
recommended (refer to tables 3-7 and 3-8 and figure 3-6). 

The relative values of the QUEUE and SERVICE parameters, both among service classes 
and within a service class, affect system performance. For an example of ranges of service 
class priorities, refer to figure 3-6. For an example set of specific entries for the QUEUE 
and SERVICE parameters, refer to tables 3-7 and 3-8. 



60459300 U Deadstart Decks 3-109 



IPRDECK 



Control Points 



A job leaves a central memory control point when any of the following conditions are present: 

• A job completes, aborts, or is suspended. 

• A system request causes a job to be rolled out to wait for a resource to become available 
or for a specified time period to elapse. 

Such system requests include a job request for a tape or disk pack, a ROLLOUT 
command, and execution of the ROLLOUT macro. 

• Terminal input/output is required. 

A job leaves central memory when the following conditions occur: 

- The system requests terminal input and typeahead input is not available. 

- You request terminal output and the recall parameter is specified on the request. 

- You issue a RECALL macro after a request for terminal output that omitted the 
recall parameter. 

• The control point is made available for a higher priority job. 

This ensures reasonable service to all users in the system. The operating system 
controls the amount of time each type of job can be at a control point. This ensures that 
one job does not monopolize system resources. 

When a job is rolled out, the priority increases as time passes, giving that job a better 
chance to be selected for execution again. When the job is selected and rolled in, its 
priority is changed to the value of the UP parameter on the QUEUE entry, and the job 
scheduling priority cycle begins again. This description on job rollout applies to local 
batch, remote batch, and interactive jobs that are not doing interactive I/O. For 
interactive jobs that do terminal I/O within a time slice, scheduling priority is slightly 
different. When I/O is complete and input, for example, is available, the system assigns 
the rolled-out job the terminal I/O scheduling priority (TP parameter on the SERVICE 
entry). The TP parameter can be used to give the job a priority equal to the priority of 
jobs still within their initial time slice, an advantage over jobs in a second time slice, 
and a larger advantage over jobs in a third or higher time slice. 

If a job at a control point exceeds the central memory time slice and it is not a 
subsystem, the scheduling priority is set to the initial lower or lower bound priority (the 
IL or LP parameter on the QUEUE entry) for its service class. Thus, any job in the 
queue with a higher priority forces the executing job with the lower priority to be rolled 
out. The rolled-out job ages normally until its priority is higher than the priorities of 
either the jobs in the input queue or a job that is executing; then it is again scheduled 
to a control point. 

Once a job is scheduled, it is desirable to use the resources allocated before another job 
forces it out. If a job maintained its scheduling priority when it was assigned to a 
control point, another job could age past that job and force it to be rolled out before it 
had an opportunity to use its time slice. For this reason, when a job is assigned to a 
control point and its priority is within the queue aging range, it is given a priority equal 
to the highest priority (the UP parameter in the QUEUE entry) for its service class. 
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Pseudo-control Points 

If pseudo-control points are defined, a job that is forced out of a control point may remain in 
central memory at a pseudo-control point, rather than being rolled out to a mass storage 
device. 

• If the job is preempted by a higher priority job, the scheduling priority stays the same. 

• If the job's control-point time slice has expired, the scheduling priority drops to the 
control-point slice priority. 

Jobs with the following characteristics are excluded from using pseudo-control points: 

• Connection to a system control point. 

• Accumulator overflow flags set. 

• Assigned to the first control point or the last control point. 

• Error flag set. 

Number of Control Points and Pseudo-control Points Available 

Selecting the number of control points available on the system depends on the amount of 
memory space available, the job mix, and the mode in which the system is being run. Up to 
34 8 control points can be defined. Each control point needs 200 8 words of CME space. For 
example, if an installation is ranning only TAF, then four or five control points may suffice. 
On the other hand, if the system is running a large number of interactive terminals with 
heavy permanent file activity, 20 or more control points may be needed. You may need to 
study memory and control point use in order to correctly determine the setting of this 
option. The DSD W,R display and/or the ACPD and PROBE utilities may be useful in 
making this determination. 

• If memory use is high and control point use is low, select fewer control points. 

• If control point use is high and memory use is low, select more control points. 

Selecting the number of pseudo-control points depends on the same variables that are used 
to determine the number of control points. Up to 34 8 pseudo-control points can be defined. 
The pseudo-control points provide more effective use of central memory in environments 
where an insufficient number of control points create a system bottleneck. Like a control 
point, each pseudo-control point needs 200 8 words of CMR space. 

• If memory use is high and control point use is lower, do not select any pseudo-control 
points. 

• If control point use is high and memory use is low, select pseudo-control points. 
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CPU Scheduling 

Job scheduling can be managed by controlling access to memory (by rollin and rollout) and 
control points (by moving jobs between control points and pseudo-control points). It is also 
possible to directly control the allocation of CPU time to jobs by specification of service class 
CPU scheduling parameters. This method may become necessary when many jobs can fit 
into memory simultaneously (jobs may not roll out when their central memory slice expires) 
or when there are enough control points for all contending jobs (jobs may not move to 
pseudo-control points when their control point slice expires). 

The system maintains a CPU wait queue of all jobs that are ready to run, sorted in 
descending order by CPU priority. Whenever the job currently executing in a CPU must 
give up the CPU for some reason, the first job on the queue that can use the CPU is selected 
for execution. Seasons for giving up the CPU include: 

• Going into recall status to wait for I/O to complete. 

• Preemption by a higher priority job. 

• Expiration of the jobs' CPU slice. 

The CPU slice is the method of distributing CPU service among jobs at the same CPU 
priority. A CPU slice is a time value expressed in milliseconds. When a job has completed 
its CPU slice, it is inserted into the CPU wait queue behind jobs with the same CPU 
priority that have time remaining in their CPU slices. When all jobs with the same CPU 
priority have completed their CPU slices, jobs with completed CPU slices are again selected 
for execution. 

The CPU slice does not have to be a continuous span of time. For example, if a job is giving 
up the CPU frequently to wait for I/O, the job's CPU slice is typically interleaved with that 
of other jobs. Jobs performing I/O will be given preference in obtaining the CPU under 
these circumstances: 

• If a job gives up the CPU to wait for I/O, that job is recalled when the I/O is complete. 

• A job that has been recalled and has not completed its CPU slice is inserted into the 
CPU wait queue before those jobs at the same CPU priority that have not been recalled. 

• A job that has been recalled and has completed its CPU slice is inserted into the CPU 
wait queue behind those jobs at the same CPU priority that have not completed their 
CPU slice. However, such a job is inserted into the wait queue before jobs at the same 
CPU priority that have completed their CPU slice but have not been recalled. 

The US (unextended CPU slice) SERVICE parameter allows specification of different CPU 
slice values by service class. If there is an intensive CPU-bound job mix, jobs in service 
classes with longer CPU slices receive proportionately more CPU service than jobs of the 
same priority in service classes with shorter CPU slices. 

The SE (CPU slice extension) SERVICE parameter defines an additional maximum amount 
of time that may be added, if needed, to the CPU slice of jobs performing I/O and using 
significant amounts of CPU time. This parameter improves the I/O transfer rate that the 
job achieves and may improve overall system throughput. However, this improvement is at 
the expense of a more exactly proportional allocation of CPU service to CPU intensive jobs. 
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The RS (recall CPU slice) SERVICE parameter defines the minimum guaranteed amount of 
time that a recalled job keeps the CPU before it can be preempted by another recalled job at 
the same CPU priority. This parameter is not involved in determining the amount of CPU 
time allocated to a job and normally should be set to the same value for all service classes. 
However, under unusual circumstances in which the I/O behavior of jobs in a service class is 
consistent and well understood, it may be possible to optimize their performance with a 
nonstandard RS value. 

Memory Control 

You can control the maximum memory allowed for job types and for service classes with the 
parameters you specify on the SERVICE and DELAY entries in the IPRDECK 

These parameters specify these lengths: 

• Maximum field length divided by 100 8 for a job in a service class. 

• Maximum field length divided by 100 8 for all jobs of the specified service class. 

• Maximum extended memory length in words divided by 1000 8 for a job in a service class. 

• Maximum extended memory length in words divided by 1000 8 for all jobs of the 
specified service class. 

• Amount of central or extended memory to leave between job field length, if possible. 

Initially, the scheduler attempts to find the highest priority job that meets the memory 
constraints. However, if the scheduler is unable to schedule a job and has explicitly rejected 
one or more jobs because the total field length or the total extended memory field length for 
a service class would be exceeded, it attempts to schedule a job a second time if flexible 
partitions are enabled (refer to FLEXIBLE PARTITIONS in this section). During this 
second attempt, any job that requires other jobs to be rolled out is not scheduled; otherwise, 
the constraints (service class total field length and total extended memory field length) are 
ignored, and the job is scheduled at the lower bound priority, LP (a parameter on the 
QUEUE entry). This means that the constraints are applied as long as there are enough 
jobs of each service class. However, if central memory is unused and no other jobs are 
available, the scheduler attempts to schedule the jobs without the constraints. 

All of these parameters can be changed by using the SERVICE, QUEUE, and DELAY 
entries. 
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Example of Job Control Parameters 

An example set of entries for the job control parameters is shown in tables 3-7 and 3-8. 
These entries fall within the example of ranges of service class priorities shown in figure 
3-7. Neither the specific entries nor the ranges are recommended; they are strictly examples 
to aid you in selecting QUEUE and SERVICE entry parameters. 

The following discussion indicates the significance of the values chosen and how they relate 
to each other. 

The entry (lowest) priority (LP parameter in the QUEUE entry) of the system service class 
input queue is higher than all entry priorities, except the network supervision and 
subsystem entry priorities, because it is assumed that an operator-initiated job should 
receive prompt attention. A system job rolls out any batch job. The entry priority (LP) of 
the network supervision service class input queue is set high to ensure adequate response 
time from network programs and facilities such as CS, NS, and NVF. 

The queue priorities for local batch, remote batch, and detached jobs are similar. The time 
slice for detached jobs is shorter than for the local batch and remote batch jobs. The 
assumption is that detached jobs need less CPU time than either local batch or remote 
batch jobs. 

The queue priorities are explained under Job Scheduling earlier in this section. 

The time slices for the various service classes reflect the following objectives: 

• To keep system jobs with their high entry priority from monopolizing system resources. 

• To keep at a minimum rollout activity caused by diagnostics running as maintenance 
service class jobs. 

• To allow most interactive jobs to compile, load, and begin execution in one time slice. 

• To give batch jobs a large time slice, because little is gained from rolling out batch jobs. 
There is no problem with the time slices for batch jobs compared to interactive jobs, 
because, with the priorities shown, an interactive job generally causes a batch job to roll 
out. 

• To ensure prompt service to all interactive users, without employing an excessive 
number of rollouts, by setting the time slices for interactive jobs low. The time slice 
parameters are critical to good interactive performance. In some cases, depending on 
the system load, job size, and so forth, it may be desirable to change these parameters 
during operation. 
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Interactive performance is sensitive to the relative values of the QUEUE and SERVICE 
scheduling parameters, both within a service class and among service classes. Tables 3-7 
and 3-8 show almost no overlaps of values except that local batch, remote batch, and 
detached jobs could age slightly past interactive jobs if they remained rolled out for a very 
long time (about 26 minutes). For the interactive service class, the range between entry 
(lowest) priorities and the highest priority is wide, so that few jobs are at the highest 
priority simultaneously. If many jobs reach the highest priority, their priorities are the 
same, and the order in which the jobs entered the queue is lost. The job scheduler selects 
jobs with equal queue priority in a random manner. The terminal I/O priority (TP) is set 
slightly higher than the initial priority (IP) to reduce response time for the user interacting 
with a job as compared to the user initiating a new job step. This parameter setting 
improves the perceived responsiveness of the system for the interactive users. 

The CPU priorities reflect the following objectives. 

• The maintenance service class jobs are run at the lowest priority. This handles the 
background CPU and memory diagnostics. 

• All other jobs, except network supervision service class jobs, run at the same priority. It 
is generally not desirable to run one class of jobs at a higher priority than another 
because the system would roll in jobs that occupy memory without executing, until they 
exceed the central memory time slice. 

• The network supervision service class is set high to ensure adequate performance from 
network programs and faculties such as CS, NS, and NVF. 

The CPU slice parameters in the example are the same for all service classes. In this case, 
all jobs that contend for the CPU with the same CPU priority receive equal service. An 
individual job performing I/O may receive more CPU service if it has the non-zero CPU slice 
extension than CPU-bound jobs with the same CPU priority. 

If sufficient memory is available to allow many jobs to remain in central memory at control 
points and pseudo-control points, it may be necessary to set differing CPU slice values 
(using the SERVICE command US parameter) to achieve the desired allocation of CPU time 
to jobs in different service classes. Job rollout is less frequent and may not deny service to 
jobs in service classes with relatively small central memory slices. Setting the CPU slice 
(SERVICE command US parameter) larger for one service class than for another results in 
jobs in the first service class receiving proportionately more CPU time than jobs in the 
second class when all the jobs are at control points and contending for the CPU. 
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Table 3-7. Example Set of Job Control Parameters, Part I 



Service Class 5 


LP 1 


UP 1 


WF 1 


LP 2 


UP 2 


WF 2 


EP2 


EL 2 


TP 3 


SY (system) 


7770 


7776 


1 


2000 


7000 


1 


7000 


4000 


- 


BC (local batch) 


10 


4000 


1 


1000 


4004 


1 


2000 


2000 


- 


RB (remote 
batch) 


10 


4000 


1 


1000 


4004 


1 


2000 


2000 


- 


CT 

(communication 
task) 


7770 


7776 


1 


3000 


7000 


1 


7000 


4000 




TS 
(interactive) 


7000 


7770 


1 


3700 


7000 


1 


4004 


3770 


4024 


NS (network 
supervision) 


7770 


7776 


1 


7770 


7776 


1 


7772 


7772 


- 


DI (detached) 


10 


4000 


1 


1000 


4000 


1 


2000 


2000 


- 


SS 
(subsystem) 


7770 


7776 


1 


7770 


7776 


1 


7772 


7772 


- 


MA 
(maintenance) 


1 


10 


1 


1 


10 


1 


10 


4 


— 


*n 

(Installation) 4 


10 


4000 


1 


1000 


4004 


1 


2000 


2000 


— 



1. Input queue QUEUE parameter. 

2. Execution queue QUEUE parameter. 

3. Interactive job initial scheduling TP SERVICE parameter. 

4. Installation classes 10, II, 12, and 13 all have release values the same as class BC. 

5. All values are octal; DELAY parameters are JS=1, CR=30, AR=1750, and MP=400. 
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Table 3-8. Example Set of Job Control Parameters, Part II 



Service Class 6 


LP 1 


UP 1 


WF 1 


CT 2 


CM 2 


CP 3 


NJ 4 


TD 5 


SY (system) 


7000 


7776 


1 


10 


20 


6770 


7777 


- 


BC (local batch) 


1 


4000 


1 


20 


200 


3770 


7777 


- 


RB (remote batch) 


1 


4000 


1 


20 


200 


3770 


7777 


- 


CT (communication 

task) 


7000 


7776 


1 


10 


200 


6770 


7777 


— 


TS (interactive) 


1 


7000 


1 


10 


10 


6770 


7777 


113 8 


NS (network 
supervision) 


1 


7000 


1 


10 


200 


7770 


7777 


— 


DI (detached) 


1 


7000 


1 


20 


20 


3770 


7777 


341 9 


SS (subsystem) 


7400 


7776 


1 


10 


20 


7770 


7777 


- 


MA 
(maintenance) 


7000 


7776 


1 


10 


20 


1 


7777 


— 


(installation 7 ) 


1 


7000 


1 


10 


200 


3770 


7777 


— 



1. Output queue QUEUE parameter. 

2. Time slice SERVICE parameters. 

3. Control point slice priority CP SERVICE parameter. 

4. Number of jobs NJ SERVICE parameter. 

5. Time-out delay TD SERVICE parameter. 

6. All values are octal; DELAY parameters are JS=1, CR=30, AR=1750, and MP=400. 

7. Installation classes 10, II, 12, and 13 all have release values the same as class BC. 

8. A TS suspended job times out after 10 minutes when the time-out delay is 113. 

9. A DI suspended job times out after 30 minutes when the time-out delay is 341. 
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Table 3-9. Example Set of Job Control Parameters, Part HI 

Service Class PR 1 RS 2 SE 3 US 4 

SY (system) 

BC (local batch) 

RB (remote batch) 

CT (communication task) 

TS (interactive) 

NS (network supervisor) 

DI (detached) 

SS (subsystem) 

MA (maintenance) 

In (installation) 5 

1. CPU priority PR SERVICE parameter. 

2. Recall CPU slice RS SERVICE parameter. 

3. CPU slice extension SE SERVICE parameter. 

4. Unextended CPU slice US SERVICE parameter. 

5. Installation classes 10, II, 12 and 13 all have release values the same as class BC. 



30 


4 


20 


20 


30 


4 


20 


20 


30 


4 


20 


20 


30 


4 


20 


20 


30 


4 


20 


20 


74 


4 


20 


20 


30 


4 


20 


20 


70 


4 


20 


20 


2 


4 


20 


20 


30 


4 


20 


20 
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10000 T 



7400- • 



7000- - 



8400 



WM0-- 



5400-- 



6000- - 



> 



5 4000- ■ 

> 






L|PJL,B.1P,1L,| 
CP CP 



I 



34C0- 



3OO0-- 



2400-- 



2000- 



1400-- 



1000" 



IP IP-i 
CP CP 



IL 



IL. 



-CP 



TP 
■IP 
IL |-CP 



IPJL 



IP.IL 



IP.IL 



IP 



SV BC BB CT TS MS M SSmSYBCBBCTTSWSWSSMASYBCRBCTTCWSDI 
INPUT EXECUTION OUTPUT 



Figure 3-7. Example of Ranges of Service Class Priorities 
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IPRDECK Entries Made Only During Deadstart 

You can enter the following IPRDECK entries only during deadstart. They cannot be 
entered as DSD commands. Changes to the IPRDECK are not retained across deadstart 
unless a new deadstart file is created to reflect those changes. The entries are described in 
alphabetical order. 

COMLIB 

Format: 

COMLIB, username, family, D. 
Default: 

None. 

Significance: 

This entry specifies a user name and family for a library of permanent files that can be 
accessed by users on all other families. This feature eliminates the need to maintain 
duplicate copies of the files on the families that require access to the files. This entry 
can also be used to reduce validation file accesses for user names such as LIBRARY in a 
single family environment. The number of COMLIB entries that can be specified is 
controlled by the CMRDECK entry CLT. 

Parameter Description 

username The 1- to 7-character user name to be associated with the files to be 

accessed. This parameter should be unique to all families in the system. 
It cannot be associated with more than one family. 

family Family name to be associated with username. If (zero) is specified, the 

system default family name is used. 

D If D is specified, the associated username and family are deleted from 

the common library table. 



CPM 

Format: 

CPM, s-j^n-L , s 2 =n 2 - 
Default: 

System selection. 

Significance: 

This entry alters the central processor multiplier of type Sj, which is used in SRU 
calculations. The Sj parameters are either or 1 to indicate the multipliers SO or Si, 
respectively. Entering 0=n obtains a multiplier to be used for SO and entering l=n 
obtains a multiplier to be used for Si. (Refer to the NOS Version 2 Administration 
Handbook for a discussion of multiplier use.) The values of nj range from 1 to 47 8 and 
are used as indexes to values defined in COMSSRU in order to determine the multiplier 
value. The default values are listed in table 3-10. 
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Table 3-10. 


CPM Default 1 
COMSSRU 


/allies for 


*h 








Mainframe 


COMSSRU Default 




iij (Octal) 


Name 


Model 




Multiplier Value 




1 


CP62 


6200 




1.0 




2 


CP64 


6400 




1.0 




3 


CP65 


6500 




1.0 




4 


CP66 


6600 




1.0 




5 


CP67 


6700 




1.0 




6 


CP71 


71 




1.0 




7 


CP72 


72 




1.0 




10 


CP73 


73 




1.0 




11 


CP74 


74 




1.0 




12 


C171 


171 




1.0 




13 


C172 


172 




1.0 




14 


C173 


173 




1.0 




15 


C174 


174 




1.0 




16 


C175 


175 




1.0 




17 


C176 


176 




1.0 




20 


C720 


720 




1.0 




21 


C730 


730 




1.0 





(Continued on next page) 
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Table 3-10. CPM Default Values for Uj 



nj (Octal) 



COMSSRU 

Name 



Mainframe 
Model 



COMSSRU Default 
Multiplier Value 



(Continued from previous page) 



22 


C740 


740 




1.0 


23 


C750 


750 




1.0 


24 


C760 


760 




1.0 


25 


C810 


810 




1.0 


26 


C815 


815 




1.0 


27 


C825 


825 




1.0 


30 


C830 


830 




1.0 


31 


C835 


835 




1.0 


32 


C840 


840 




1.0 


33 


C845 


845 




1.0 


34 


C850 


850 




1.0 


35 


C855 


855 




1.0 


36 


C860 


860/870 




1.0 


37 


C865 


865 




1.0 


40 


C875 


875 




1.0 


41 


C961 


960-11 




1.0 


42 


C963 


960-31/32 




1.0 


43 


C990 


990/994/995 


1.0 


44 


ICM1 


Model on 


which 


1.0 






you are installing. 




45 


ICM2 


Model on 


which 


2.0 






you are installing. 




46 


ICM3 


Model on 


which 


3.0 






you are installing. 




47 


ICM4 


Model on 


which 


4.0 






you are installing. 




50 


ICM5 


Model on 


which 


5.0 






you are installing. 
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CSM 

Format: 

CSM=csm. 

Default: 

64 

Significance: 

This entry sets the operating system character set mode. To change the character set 
mode for the products, a change must be made in IPAEAMS, and the products must be 
reassembled. 

csm Description 



63 63-character set. 

64 64-character set. 

The system assumes a 64-character set if there is no CSM entry in the current 
IPRDECK 



NOTE 



Unpredictable and possibly serious problems occur if the operating system is operating 
in one character set and the products are operating in another. Therefore, ensure that 
all installed products and the operating system are in the same mode. 



DISK VALIDATION 

Format: 

ENABLE, DISK VALIDATION. 
DISABLE, DISK VALIDATION. 

Default: 

Enabled. 

Significance: 

NOS performs hardware verification on each mass storage device during the deadstart 
process before users are allowed to access the device. The hardware verification 
sequence includes writing data to the disk, reading the data from the disk, and finally 
comparing the read data with the write data to ensure integrity. For 887 and 9853 
disks, the hardware verification includes running in-line diagnostics. Since the 
diagnostics verify the quality of the disk media more completely, it is advantageous to 
run them. These diagnostics take approximately 3 minutes to execute, during which 
time the 887 or 9853 disk is not available for use. In order to keep deadstart time to a 
minimum (such as, during testing), disk validation can be disabled using the 
DISABLE,DISK VALIDATION command. 
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DSD 

Format: 

DSD, level, conimand 1 #command2# . . .ttcommandjj 
Default: 

None. 

Significance: 

This entry specifies the initial command(s) to be executed by the DSD program when 
the deadstart is complete. The commands can be the minimum number of characters 
recognizable by DSD but must include terminating characters. Only the last DSD entry 
on the IPRDECK for a given deadstart level is processed; other DSD entries for the 
same level are ignored. The DSD entry cannot exceed one line and a maximum of 60 
characters can be specified. 

Parameter Description 

level Level of deadstart (0, 1, or 2). 

command^ DSD command to be executed for the level of deadstart specified. 

Several commands can be specified by separating them with the # (6-bit 
display code 60) or % (6-bit display code 63) character. These characters 
may misposition parts of the console display of IPRDECK if they appear 
as the upper 6 bits in a byte. 

If you specify a series of commands including DSD display selection 
commands, the display selection commands must be the last commands. 
Failure to do so results in the system ignoring any commands following 
the DSD display selection commands. 

Examples: 

DSD, ,MAI%X.QREC (PO=N) 
DSD,0,X.QREC(PO=N)#SET / AEIQ.#QB. 
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EI 

Format: 

£1=11112 , nn 2 , . . - , nn x . 
Default: 

None. 

Significance: 

The EI entry should be used to ensure loading of the correct environment interface for 
the operating system. This entry specifies up to six 2-character environment interface 
names, one of which must be loaded while deadstarting a CYBER 180-class machine. 
The deadstart will not be allowed to continue if the environment interface loaded by 
CTI is not one of those specified by the EI entry. You will have to load the correct 
environment interface or modify the EI entry in the IPRDECK If an EI entry is not 
present, you will not be warned at deadstart. 

EXTENDED STACK PURGING 

Formats: 

ENABLE , EXTENDED STACK PURGING. 
DISABLE, EXTENDED STACK PURGING. 

Default: 

Disabled. 

Significance: 

These entries specify the default action for instruction-stack purging for 
nonsystem-origin jobs on CYBER 180-class machines. Refer to the MODE macro in the 
NOS Version 2 Reference Set, Volume 4 for a description of instruction-stack purging. 

HARDWARE FAULT INJECTION 

Formats: 

ENABLE , HARDWARE FAULT INJECTION. 
DISABLE , HARDWARE FAULT INJECTION. 

Default: 

Disabled. 

Significance: 

The entries enable and disable the simulation of hardware faults by normal jobs 
executing special instructions. This simulation is intended for test purposes only, and 
should not be enabled on a production system. 
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KEYPM 

Format: 

KEYPM=cc . 

Default: 

26 
Significance: 

This entry specifies the keypunch mode to be assumed during system operation. 

cc Description 

26 026 keypunch mode. 

29 029 keypunch mode. 

This entry is used for all batch jobs submitted if the keypunch mode is not specified on 
the job command. This does not apply to RBF. 

MEMORY CLEARING 

Formats: 

ENABLE, MEMORY CLEARING. 
DISABLE, MEMORY CLEARING. 

Default: 

Disabled. 

Significance: 

When memory clearing is enabled, central and extended memory are cleared when 
released from a job (that is, when a job is rolled out, terminates, or reduces its field 
length). When memory clearing is disabled, memory is cleared only when a job requests 
additional memory. 
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MICRO 

Format: 

MICRO=name 1 , name 2 , ■ • - , name 7 . 
Default: 

None. 

Significance: 

The MICRO entry should be used to ensure loading of the correct microcode for the 
operating system. This entry specifies up to seven 7-character microcode names, one of 
which must be loaded while deadstarting a CYBER 180-class machine. The deadstart 
will not be allowed to continue if the microcode loaded by CTI is not one of those 
specified by the MICRO entry. You will have to load the correct microcode or modify the 
MICRO entry in the IPRDECK If a MICRO entry is not present, you will not be 
warned at deadstart. 

NAMIAF 

Format: 

NAMlAF=maxt . 
Default: 

200 8 
Significance: 

This entry specifies the number of network terminals that can be connected to IAF at 
one time. The maximum number of terminals IAF can support is 1039. However, this 
value is dependent on the number of network terminals, multiplexer ports, and 
stimulator ports specified in the deadstart decks. 



Parameter Description 

mast Total number of network terminals; maxt can range from 1 to 1440 8 . 

PROBE 

Formats: 

ENABLE, PROBE. 
DISABLE, PROBE. 

Default: 

Disabled. 
Significance: 

These entries enable and disable the data gathering facility of CPUMTR. 
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SCP 

Formats: 

ENABLE, SCP. 
DISABLE, SCP. 

Default: 

Disabled. 

Significance: 

These entries specify whether to use the system control point facility. You must enable 
SCP if CDCS, IAF, MAP, MCS, MSE, NAM, NVE, PLA, RBF, RHF, SMF, SSF, or TAF 
will be used. If none of these will be used, leave SCP disabled so that more CMR space 
is available. 

SCRSIM 

Formats: 

ENABLE, SCRSIM. 
DISABLE, SCRSIM. 

Default: 

Disabled. 

Significance: 

These entries enable or disable the simulation of the status/control register using the 
interlock register on CYBER 70 Computer Systems (refer to appendix D for information 
on the SCRSIM simulator). 
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SECCATS 

Format: 

SECCATS=cat 1 ,cat 2 , - • • ,cat n . 
Default: 

All categories are enabled. 
Significance: 

This entry specifies the security access categories that will be allowed in the system for 
processing when the system is in a secured mode. The values should be supplied by a 
site security administrator. Refer to the NOS Version 2 Security Administrator's 
Handbook. 

Parameter Description 

catj Category names specified in deck COMSMLS corresponding to the 

desired access categories. Initially, all categories are enabled. The first 
SECCATS entry clears all categories, then sets the specified categories. 
Subsequent SECCATS entries set additional categories: 

SECCATS=ALL. Enables all 32 categories. 

SECCATS=NUL. Disables all 32 categories. 



SPC 

Format: 

SPC, d= lines. 
Defaults: 

64 lines at 6 lines per inch. 

85 lines at 8 fines per inch. 
Significance: 

This entry specifies the charge in number of lines for a page of printed output at the 
specified print density on non-PFC printers. 



Parameter Description 



d Density in lines per inch; d can be 6 or 8 lines per inch, but must be 

specified in octal (6 or 10 8 ). 

lines Lines per page; lines can range from 16 to 255, but must be specified in 

octal (20 8 to 377 8 ). 
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SPD 

Format: 

SPD=d. 
Default: 

6 
Significance: 

This entry specifies the assumed density for printed output. 

d Description 



6 6 lines per inch. 
10 8 8 lines per inch. 

SPL 

Format: 

SPL=length . 
Default: 

60 

Significance: 

This entry specifies the assumed page length in number of lines for printed output; 
length can range from 16 to 255, but must be specified in octal (20 8 to 377 8 ). 

SPW 

Format: 

SPW=width . 
Default: 

136 

Significance: 

This entry specifies the assumed page width in number of characters for printed output; 
width can range from 40 to 136, but must be specified in octal (50 8 to 210 8 ). 
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SUBCP 

Formats: 

ENABLE, SUBCP. 
DISABLE, SUBCP. 

Default: 

Disabled. 

Significance: 

These entries specify whether CPUMTR is to be initialized to handle subcontrol point 
(TAF) processing. 

If SUBCP is disabled, CPUMTR is not initialized to handle subcontrol point processing. 
If you are not running TAF and if no user applications use subcontrol point processing, 
disable SUBCP so that CPUMTR uses less central memory. 

TCVM 

Format: 

TCVM=mode . 
Default: 

AS 
Significance: 

This entry sets the tape to be assumed during system operation. 

mode Description 

AS ASCII 9-track conversion. 

US ANSI (previously known as USASI) 9-track conversion (same as AS). 

EB EBCDIC 9-track conversion. 
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TDEN 

Format: 

TDEK=dens i ty . 
Default: 

HY for 7-track tapes. 

PE for 9-track tapes. 

Significance: 

This entry sets the system tape density. When the density is set, any tape unit 
accessed is automatically set to this density unless specified otherwise by a magnetic 
tape request. Two TDEN entries may be present, one for 7 track and one for 9 track. 

density Description 

LO 200 cpi (7 track). 

HI 556 cpi (7 track). 

HY 800 cpi (7 track). 

HD 800 cpi (9 track). 

PE 1600 cpi (9 track). 

GE 6250 cpi (9 track). 

TDTY 

Format: 

TDTY=devicetype . 
Default: 

NT 
Significance: 

This entry sets the default tape device type. 

devicetype Description 

AT Automated Cartridge Subsystem (ACS). 

CT Cartridge Tape Subsystem (CTS). 

MT 7-track tape device. 

NT 9-track tape device. 
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TMS 
Formats: 

ENABLE , TMS . 
DISABLE, TMS. 

Default: 

Disabled. 

Significance: 

These entries enable and disable the Tape Management System (TMS). These entries 
are meaningless if the TMS binaries are not installed in the deadstart file. 

TMSTO 

Format: 

TMSTO , N=to , S=tO . 

Default: 

N=TC,S=FC 

Significance: 

This entry specifies the default values for the TMS tape options parameter for the 
LABEL command and the LABEL macro. The N parameter specifies the default for 
nonsystem origin jobs and the S parameter specifies the default for system origin jobs. 

to Description 

TC Sets the default to TO=TC (TMS processing with catalog error checking). 

TE Sets the default to TO=TE (TMS processing without catalog error checking). 

FC Sets the default to TO=FC (non-TMS processing with catalog error checking). 

FE Sets the default to TO=FE (non-TMS processing without catalog error 
checking). 

This entry is meaningless if TMS is disabled. 
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TRACE 

Formats: 

ENABLE, TRACE. 
DISABLE, TRACE. 

Default: 

Disabled. 

Significance: 

The entries enable or disable specification of monitor functions and other system data 
to be traced, the TRACE and TRAP capabilities. To use these capabilities, 
ENABLE,SYSTEM DEBUG, must also be entered. 
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IPRDECK Entries 

You can enter the following IPRDECK entries during deadstart and online during system 
operation using the L display or DSD commands. The reason for entering them online is to 
change the system's operation between deadstarts. Entries made during system operation 
are not retained across deadstarts. Entries made during deadstart are not retained across 
deadstarts unless a new deadstart file is created to reflect the changes. 

A description of the enabling and disabling of subsystems follows. The remaining IPRDECK 
entries are described in alphabetical order. 



Subsystems 

You can initiate a subsystem by either of the following methods: 

Enter an explicit call to the subsystem procedure using a DSD command. The command 
format is: 



• 



subffff 
Variable Description 



sub 3-character mnemonic for the name of the subsystem and subffff is the 

name of the subsystem procedure (refer to Subsystem Control Commands 
in section 5). 

Enter the DSD command AUTO or MAINTENANCE. This will initiate calls to all 
subsystems that are currently enabled. The calls will be to subsystem procedures with 
the same name as the name of the subsystem. You can choose to have either the AUTO 
command or the MAINTENANCE command issued automatically at deadstart time by 
specifying the command on the DSD entry in the D7RDECK 



NOTE 



You cannot use either of the preceding methods to initiate the ATF, MCS, and RBF 
subsystems. The NAM subsystem automatically initiates them if they are selected in the 
NAM startup file. 



A subsystem procedure may be either a record in the deadstart file or a permanent file 
under system user name SYSTEMX (user index 377777 8 ). If a subsystem procedure with 
the same name is present in both places, the permanent file copy will be used. 



NOTE 



Before you initiate a subsystem that uses the system control point facility (such as NAM or 
CDCS), you must enable the system control point facility with the ENABLE.SCP IPRDECK 
entry. Refer to SCP earlier in this section. 

All subsystems, except BIO and MAG, are disabled by default. You can enable or disable a 
subsystem by using IPRDECK entries or by using the SUBSYST L-display utility. (For 
information about the SUBSYST L display, refer to the NOS Version 2 Operations 
Handbook.) 
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The IPRDECK entries that enable and disable subsystems may also assign a required 
control point for a subsystem. Thus, even if you do not want to enable a subsystem, you 
may want to explicitly disable a subsystem with an IPRDECK entry to assign a required 
control point for the subsystem. 

NOTE 

If you choose to specify a control point for any subsystem, it is recommended that you 
specify a unique control point for each subsystem. Otherwise, a subsystem may not be able 
to initiate successfully because its designated control point is already occupied by another 
subsystem. When this happens, the subsystem being initiated waits indefinitely for the 
other subsystem to give up the control point. 

Use these IPRDECK entries to enable or disable a subsystem: 

ENABLE, subsystem, cp. 
DISABLE, subsystem, cp. 

Parameter Description 

subsystem Three characters that select the desired subsystem; one of these values: 

subsystem Description 

ATF Automated Tape Facility. The ATF subsystem must be active 

before users can access the tape units for the Automated 

Cartridge Subsystem (ACS). 

BIO Local batch I/O for central site line printers, card readers, and 

card punches. 

CDC CYBER Database Control System. 

CYB CYBIS-NAM Interface. 

IAF Interactive Facility. Do not specify the cp parameter on the 

ENABLE entry for IAF. 

MAG Magnetic Tape Subsystem. Even if your users do not use 

magnetic tapes, enable MAG if removable auxiliary packs are 
used. Disabling MAG frees a control point for other use. 

MAP MAP III or MAP IV. 

MCS Message Control System. 

MSE Mass Storage Extended Subsystem. 

NAM Network Access Method. 

NVE NOS/VE Dual-State Interface. 

RBF Remote Batch Facility. 
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Parameter Description 



subsystem (Continued) 



subsystem Description 



RDF Remote Diagnostic Facility. Do not specify the CP parameter 

on the ENABLE entry for RDF. 

RHF Remote Host Facility. 

SMF Screen Management Facility. 

SSF NOS-SCOPE 2 Station Facility. 

STM Interactive Stimulator. 

TAF Transaction Facility. 

NOTE 

Since ATF, MCS and RBF are started by the NAM subsystem (if they are 
selected in the NAM startup file), the ENABLE and DISABLE commands 
establish only the control points at which the subsystems will run. 

If an ENABLE is made for NVE and the subsystem procedure name is also 
NVE, use the DOWN,CH EQPDECK entry to automatically down any 
channels that NOS/VE uses. 

If STIMULA is used as the interactive stimulator, you must enable the STM 
subsystem at the last control point. 

cp Control point where the subsystem will reside. If you omit cp, the current 

control point is used. If you enter (zero) as the control point, the subsystem 
may reside at any available control point. If you enter -n as the control 
point, the subsystem's control point will be relative to the system control 
point (-1 would be the last control point before the system control point). 

Omit cp for IAF and RDF. 



ACS TAPE PF STAGING 

Formats: 

ENABLE, ACS TAPE PF STAGING. 
DISABLE, ACS TAPE PF STAGING. 

Default: 

Disabled. 
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Significance: 

These entries specify whether permanent files that reside on Automated Cartridge 
Subsystem (ACS) tape alternate storage are automatically staged to disk. If disabled, 
jobs that attempt to access permanent files residing only on ACS tapes are aborted. 
Contrast this entry with the CARTRIDGE PF STAGING entry, which controls staging 
from MSE or optical disk, and the TAPE PF STAGING entry, which controls staging 
from 9-track tapes and CTS tapes. 

AUTORESTART 

Formats: 

ENABLE , AUTORESTART . 
DISABLE , AUTORESTART . 

Default: 

Enabled. 

Significance: 

These entries enable or disable the AUTORESTART installation parameter. If 
AUTORESTART is enabled and if step mode is set during an environmental shutdown, 
the system automatically clears step mode when the power environment returns to 
normal. All jobs waiting in the input and rollout queues are initiated by performing the 
processing associated with the DSD AUTO command. This recovery process requires no 
operator interaction. 

If AUTORESTART is disabled and step mode is set during an environmental shutdown, 
the operator must manually enter the UNSTEP and AUTO commands when the 
message POWER/ENVIRONMENT NORMAL is displayed at the system control point. 

CARTRIDGE PF STAGING 

Formats: 

ENABLE, CARTRIDGE PF STAGING. 
DISABLE, CARTRIDGE PF STAGING. 

Default: 

Disabled. 

Significance: 

These entries specify whether permanent files that reside on either MSE or optical disk 
alternate storage are staged to disk. If disabled, jobs that attempt to access permanent 
files residing only on MSE or optical disk alternate storage are aborted. Contrast this 
entry with the ACS TAPE PF STAGING entry, which controls staging from ACS tapes, 
and the TAPE PF STAGING entry, which controls staging from 9-track tapes and CTS 
tapes. 
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CLASS 

Format: 

CLASS , Ot , SCjl , SC 2 , . . . , SC n . 

Default: 

Origin Type Service Class 



Batch BC 

Remote batch RB 
Interactive TS 



Significance: 

Specifies the valid service classes for each origin type. The system stores this 
information in the service class table (refer to the NOS Version 2 Systems 
Programmer's Instant). 

Parameter Description 



ot Origin type; must be BC (batch), RB (remote batch), or IA (interactive). 

This parameter is required and order dependent. 

sc- Service classes. Each class selected causes validation for that service 

class for the origin type specified by ot. Entering a service class that 
already has validation clears validation for that service class. You can 
select from 1 to 36 service classes for each origin type. This command 
does not accept class SS (subsystem). 

Service class is one of these values: 

sc Description 

BC Local batch. 

CT Communication task. 

DI Detached interactive. 

In Installation class n (0 < n < 8). 

MA Maintenance. 

NS Network supervisor. 

RB Remote batch. 

SY System. 

TS Interactive. 

ALL Causes validation of all service classes except subsystem (SS) 
and deadstart (DS). 

NUL Clears validation for all service classes. 
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CPTT 

Format: 

CPTT=n . 

Default: 

100 8 sectors. 

Significance: 

This entry specifies the CPUPFM transfer threshold (CPTT). The value of CPTT 
determines whether an indirect access file transfer will be processed entirely within the 
PP program PFM or whether the CPU program CPUPFM will be called to perform the 
transfer. Since CPUPFM can transfer large files faster than PFM, CPUPFM transfers 
files that exceed the threshold value. 

Depending on the configuration, a site can adjust this value up or down. A site with 
buffered I/O devices, for example, may find it advantageous to set a lower value. If a 
site wishes to disable CPUPFM transfers altogether, a value of zero (CPTT=0) may be 
specified. 

Parameter Description 

n CPUPFM transfer threshold value that will be defined in common deck 

COMSPFM; < n < 7777 8 PRUs. 



DEBUG 

Format: 

DEBUG. 

Default: 

Disabled. 
Significance: 

This entry selects or clears debug mode, depending upon the current status. 

If enabled, debug mode is selected. The message DEBUG appears in the header of the 
left screen display. Debug mode provides system origin privileges to validated users 
and allows modifications to be made to the running system. 

If disabled, debug mode is cleared. It is recommended that debug mode not be allowed 
in a normal production environment. 

On a secured system, this entry is ignored. While the console is in security unlock 
status, debug mode can be set using DSD command DEBUG. 
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DELAY 

Format: 

DELAY , ARar , CRcr , JQ j q , JS j s , MPmp . 
Default: 

None. 

Significance: 

This entry specifies the system delay parameters. Refer to table 3-7 for an example set 
of parameter entries. Refer to figure 3-6 for an example of ranges of service class 
priorities. 

Parameter Description ____^_______ 

ARar PP recall interval in milliseconds. This parameter specifies the default 

time interval after which a peripheral processor program in the PP 
recall queue will be recalled, ar ranges from 1 to 7777 8 . 

CRcr CPU recall period in milliseconds. This parameter specifies the amount 

of time a job remains in recall (X status) when an RCL request is placed 
in RA+1. cr ranges from 1 to 7777 8 . 

JQjq Exponent used to determine the input file scheduling interval in 

seconds, jq ranges from to 14 8 . The interval in seconds between 
scheduling of input files is calculated as follows: 

interval=2**jq 

JSjs Job scheduler interval in seconds. This parameter specifies the interval 

in which the job scheduler is called. The scheduler may also be called at 
other times, js ranges from 1 to 7777 8 . 

MPmp Memory padding value expressed as 100 8 word blocks, mp ranges from 

to 777 8 . This parameter specifies how much additional (unassigned) 
memory should be allocated between the end of the newly assigned job 
field length and the beginning of the next job. Increasing this value 
reduces the probability that a job will be storage moved in response to a 
request for more memory. 
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DDP ROLLOUT PATH 

Formats: 

ENABLE, DDP ROLLOUT PATH. 
DISABLE, DDP ROLLOUT PATH. 

Default: 

Disabled. 

Significance 

These entries determine which path a rollout to extended memory will take (CPU or 
PP). The required supporting hardware (EM or DDP) must be present. 

DFPT 

Format: 

DFPT=dtn. 
Default: 

DI1 (see the DFPT installation parameter in common deck COMSPFM). 

Significance: 

The DFPT entry resets the system default removable pack type. When accessing a 
removable auxiliary device with a permanent file command, the system checks that the 
equipment type and pack name of the device match the equipment type (R parameter) 
and pack name (PN parameter) on the command. If R is not specified, the system uses 
the equipment type specified by DFPT. 

Parameter Description 

dt Disk device type of the removable pack. 

n Number of spindles in the removable pack; 1 < n < 8. 
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ENGR 

Formats: 

ENABLE, ENGR. 
DISABLE, ENGR. 

Default: 

Disabled. 

Significance: 

These entries enable or disable engineering mode. If enabled, the ENGR message 
appears in the header of the left screen display. Engineering mode allows the 
peripheral processing unit (PPU)/hardware diagnostics and the 881/883 pack 
reformatting utility FORMAT to run while the system is in operation. 

On a secured system, these entries are ignored. When the console is in security unlock 
status, engineering mode can be enabled using the DSD command ENABLE,ENGR. 

FLEXIBLE PARTITIONS 

Formats: 

ENABLE, FLEXIBLE PARTITIONS. 
DISABLE, FLEXIBLE PARTITIONS. 

Default: 

Enabled. 

Significance: 

This entry enables or disables flexible memory partitioning. The job scheduler attempts 
to use memory space to the greatest extent possible when flexible partitions are 
enabled. Some service classes may be allotted more total memory space than memory 
partitioning constraints normally allow. If flexible partitions are disabled, the total 
memory used by jobs of a given service class are never allowed to exceed the maximum 
specified on the SERVICE command (AM and EM parameters). 



60459300 U Deadstart Decks 3-143 



IPRDECK 

FORCED FORMATTING 

Formats: 

ENABLE, FORCED FORMATTING. 
DISABLE , FORCED FORMATTING . 

Default: 

Enabled. 

Significance: 

These commands are applicable only to 583x devices. When FORCED FORMATTING is 
enabled and the INITIALIZE,FP option for a device is also specified, the driver always 
formats the device. The driver does not check whether the device is already formatted 
correctly. 

When FORCED FORMATTING is disabled and the INITIALIZE,FP option is specified 
for a device, the driver firsts checks whether the device is correctly formatted. If the 
device is already formatted correctly, the driver does not format the device. However, 
the driver does issue the clustering commands to the controller when necessary. 

If FORCED FORMATTING is enabled when the system detects that a parity drive that 
was previously offline is now online, the system automatically formats the drive before 
restoring data. 

If FORCED FORMATTING is disabled when the system detects that a parity drive that 
was previously offline is now online, the system first checks whether the drive is 
formatted correctly. The driver formats the drive only when necessary. 
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LOCK 

Format: 

LOCK. 
Default: 

Unlocked. 

Significance: 

This entry specifies the system is locked. This software function prevents entry of 
restricted commands; all other DSD commands can be entered. The console is normally 
locked when the system is being used in a production environment. 

LOGGING 

Formats: 

ENABLE, LOGGING. 
DISABLE , LOGGING . 

Default: 

Disabled. 

Significance: 

These entries specify whether dayfile messages intended for system analysis are logged 
in the dayfile. Typical messages deal with informing the user that the program is 
making inefficient CIO calls, such as reading to a full buffer or writing from an empty 
buffer. The dayfile messages are documented in an appendix of the NOS Version 2 
Operations Handbook. 
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MASTER MSE 

Formats: 

ENABLE, MASTER MSE. 
DISABLE, MASTER MSE. 

Default: 

Disabled. 

Significance: 

These entries specify whether the MSE executive program (SSEXEC), when initialized, 
is to run in master (enabled) or slave (disabled) mode. 

MS VALIDATION 

Formats: 

ENABLE, MS VALIDATION. 
DISABLE, MS VALIDATION. 

Default: 

Disabled. 

Significance: 

This entry enables or disables mass storage validation. If enabled, CMR is increased by 
48 words, and the system verifies that, for each mass storage device, the sum of the 
counts of unreserved tracks and preserved files equals values specified in the device's 
mass storage table. 

If the device is a master device (contains user catalogs), the system also verifies these 
conditions: 

• The device's track reservation table (TRT) specifies that the first tracks of the 
indirect access file chain and the permit area are reserved and preserved. 

• The label track is linked to the first catalog track. 

• The number of catalog tracks is a power of 2. 

• The catalog chain is reserved, of correct length, and contiguous if flagged as such in 
the device's MST. 

To enable/disable mass storage validation with a DSD command entry, enable the 
validation in the IPRDECK during a level 0, 1, or 2 deadstart. 
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OQSH 

Format: 

OQSH=level . 
Default: 

None. 

Significance: 

This entry specifies the value of the output queue special handling (OQSH) level. 
Output files with an access level equal to or greater than the output queue special 
handling level will remain in the queue until released by the DSD command RELEASE. 
When no OQSH level or access level name LVLO is selected, all files will be processed. 
The value for this entry is supplied by the site security administrator. 

Parameter Description 



level Access level name specified in deck COMSMLS (refer to the NOS 

Version 2 Installation Handbook) that corresponds to the desired output 
queue special handling level. 



PCLASS 

Format: 

CLASS , sc , sc x , . . . , sc 7 . 
Default: 

None. 

Significance: 

Specifies the service class associated with each priority level (PO through P7) for 
selection on the Job command (refer to the NOS Version 2 Reference Set, Volume 3). 

Parameter Description 



The 2-character service class symbol. Because parameters are positional, 
a comma must appear for any null parameter. The default for a null 
parameter is that no service class will be associated with the priority 
level represented by the null parameter's position in the string. This 
command does not accept the SS (subsystem) service class. Refer to the 
SERVICE IPRDECK entry later in this section for a list of service 
classes. 
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PF VALIDATION 

Formats: 

ENABLE, PF VALIDATION. 
DISABLE, PF VALIDATION. 

Default: 

Disabled. 

Significance: 

These entries enable or disable preserved file (PF) validation. If enabled, the system 
aborts an attach of a direct access permanent file if its end-of-information (EOD was 
altered during recovery of the file. If NA (no abort) is specified on the attach request, 
the system attaches the file. 

If mass storage validation is also enabled, TRT verification of preserved files takes place 
during a level 3 deadstart as follows: 

• For all files, the system ensures that all tracks are reserved and that no circular 
linkage exists. 

• For all queued, permanent direct-access, and fast-attach files, the system also 
ensures that the first track is preserved. 

If mass storage validation is enabled on a level 1 or 2 deadstart, TRT verification takes 
place automatically, regardless of the status of PF VALIDATION. 

PRIVILEGED ANALYST MODE 

Formats: 

ENABLE , PRIVILEGED ANALYST MODE . 
DISABLE, PRIVILEGED ANALYST MODE. 

Default: 

Disabled. 

Significance: 

These entries enable or disable privileged analyst mode operations. If enabled, a user 
validated with AW=CPAM (refer to the NOS Version 2 Administration Handbook for 
information on MODVAL validation) is permitted to read system status information 
(such as the system dayfile, account file and error log) using a nonsystem-origin job. On 
a secured system, this entry is ignored. Refer to the DSD ENABLE/DISABLE command 
in section 5 for more details. 
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PRIVILEGED RDF 

Formats: 

ENABLE, PRIVILEGED RDF. 
DISABLE, PRIVILEGED RDF. 

Default: 

Disabled. 

Significance: 

These entries enable or disable privileged mode of RDF. If enabled, a user's commands 
are checked to ensure that a maintenance function is being performed. 

QUEUE 

Format: 

QUEUE , sc , qt , ILil , IPip , LPlp , UPup , WFwf . 

Default: 

None. 

Significance: 

This entry specifies the queue priorities associated with the input, executing, and 
output queues for each job service class. Refer to table 3-7 for an example set of 
parameter entries and to figure 3-6 for an example of ranges of service class priorities. 

Parameter Description 



sc 



Service class. 




sc 


Description 




BC 


Local batch. 




CT 


Communication task. 




DI 


Detached interactive. 




In 


Installation class n (0 < n 


<8). 


MA 


Maintenance. 




NS 


Network supervisor. 




RB 


Remote batch. 




SS 


Subsystem. 




SY 


System. 




TS 


Interactive. 
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Parameter Description 



qt Job queue type. 

qt Description 



EX Executing jobs. 
IN Input queued files. 
OT Output queued files. 

ILil Priority a job receives when it initially exhausts its CM time slice (refer 

to the SERVICE command CM parameter). Thereafter, whenever the 
CM time slice is exhausted the job's priority will be set to the value of lp. 
il ranges from to 7777 8 , but must be in the range of values for lp and 
up. This parameter is valid only for executing jobs (EX). 

IPip Initial priority only for an executing batch job or for an interactive job 

when a terminal command is entered. Online interactive jobs with 
terminal I/O available are scheduled at tp priority (refer to the 
SERVICE command TP parameter), ip ranges from to 7777 8 , but must 
be in the range of values for lp and up. 

LPlp Lowest priority. For an input or output queue file, the priority assigned 

to a file or job entering the queue. For an executing job, the priority 
assigned to job which has exceeded a non-initial CM slice. The IL value 
is used for the first CM slice, lp ranges from to 7777 8 , but must be less 
than the value of up. 

UPup Highest priority. For input and output queues, this is the highest 

priority a file can reach in that queue; aging stops when this priority is 
reached. For the execution queue, this is the priority assigned to a job 
when initially assigned to a control point, up ranges from to 7777 8 , but 
must be greater than the value of lp. 

WFwf Weighting factor for queue priority calculation; wf must be a power of 2, 

from 1 to 4000 8 . The smaller the weighting factor, the faster the queue 
entry reaches its highest priority. 
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REMOVABLE PACKS 

Formats: 

ENABLE, REMOVABLE PACKS. 
DISABLE, REMOVABLE PACKS. 

Default: 

Enabled. 

Significance: 

These entries enable or disable automatic label checking for mass storage devices that 
are defined as removable. 

If enabled, automatic label checking occurs. This status must be available to perform 
label verification before removable devices can be accessed. 

If disabled, any removable devices introduced into the system will not be recognized. 

RESIDENT RDF 

Formats: 

ENABLE , RESIDENT RDF. 
DISABLE, RESIDENT RDF. 

Default: 

Disabled. 

Significance: 

These entries enable or disable resident mode of RDF. While in resident mode, RDF 
remains active, regardless of terminal inactivity, until RDF is disabled. When resident 
mode is disabled, RDF becomes inactive if no one is logged on at the remote diagnostic 
terminal for 15 minutes. 

SECONDARY USER COMMANDS 

Formats: 

ENABLE , SECONDARY USER COMMANDS. 
DISABLE, SECONDARY USER COMMANDS. 

Default: 

Disabled. 

Significance: 

The enable option allows jobs to issue more than one USER command. These entries 
are ignored on a secured system since secondary USER commands are not allowed on a 
secured system. 
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SECURES 

Format: 

SECURES , ot , LA= la , UA=ua . 

Default: 

The security access limits of the system origin type (SY) are set to access level name 
LVLO. All security access limits for other origin types are set to system limits. 

Significance: 

This entry specifies system limits for the system origin type (ot equals SY) or limits for 
other origin types (ot equals BC, IA, or RB). System limits define the highest and lowest 
levels allowed in the system. No job may execute and no file may be accessed or created 
at a level outside this range. 

Limits for origin types other than SY must be within the system limits. If origin type 
SY is specified, limits for all origin types are set to the selected values. 

Both la and ua must be entered; they can be set to the same value, restricting system 
access or a particular origin type access to a single level. These values are supplied by a 
site security administrator. 

This entry is not meaningful in an unsecured system. 

Parameter Description 

ot 



Origi 


ntype. 


ot 


Description 


SY 


System. 


BC 


Batch. 


IA 


Interactive. 


RB 


Remote batch. 



la Access level name specified in deck COMSMLS (refer to the NOS 

Version 2 Installation Handbook) corresponding to the desired lower 
access level limit. 

ua Access level name specified in deck COMSMLS corresponding to the 

desired upper access level limit. 
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SERVICE 

Format: 

SERVICE , sc , AMam, CMcm, CPcp , CScs , CTct , DSds , DTsc , ECec , EMem, FCf c , FLf 1 , 
FSf s , NJn j , PRpr , RSrs , SEse , TDtd, TPtp , USus . 

Default: 

None. 
Significance: 

This entry specifies the service limits associated with each service class. Refer to table 
3-7 for an example set of parameter entries and to figure 3-6 for an example of ranges 
of service class priorities. 



Parameter Description 



sc 



Service class; one of these values: 



sc 

BC 

CT 

DI 

In 

MA 

NS 

RB 

SS 

SY 

TS 



Description 



Local batch. 

Communication task. 

Detached interactive. 

Installation class n (0 < n < 8). 

Maintenance. 

Network supervisor. 

Remote batch. 

Subsystem. 

System. 

Interactive. 



AMam 



Maximum field length divided by 100 8 for all jobs of the specified 
service class. This parameter partitions central memory by limiting the 
field length available to each service class. For example, if scheduling a 
job to a control point would cause the AM value for its service class to 
be exceeded for its service class, it may not be scheduled until the 
required field length is available. This means that a lower priority job 
from a different service class may be scheduled first. However, a job 
that would cause the AM value for its service class to be exceeded, can 
be scheduled to a control point if not enough jobs in other service 
classes exist to fill central memory and FLEXIBLE PARTITIONS is 
enabled. The system attempts to use central memory to its greatest 
capacity, am ranges from to 77777 8 . 
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Parameter 



Description 



CMcm 



CPcp 



CScs 



Central memory time slice in seconds. This parameter specifies the 
maximum amount of time a job of the specified service class can 
remain in central memory either at a control point or at a 
pseudo-control point before its priority is set to the lower boundary. 
When the job initially exhausts its CM time slice, this lower boundary 
is the value of il. Subsequently, when the job exhausts its CM time 
slice, this lower boundary is the value of lp (refer to the QUEUE 
command IL and LP parameters), cm ranges from to 7777 g . 

Control point slice priority. This parameter specifies the value of the 
scheduling priority which will be set after a job has been at a control 
point for ct seconds. The priority specified must be greater than or 
equal to the lower bound and less than or equal to the upper bound 
execution queue scheduling priorities specified by the CB parameter 
(lp < cp < up). Refer to the QUEUE command LP and UP parameters. 

Cumulative size in PRUs allowed for all indirect access permanent 
files, cs indicates a limit value for the cumulative size. 



es 



Limit Value 




1 
2 
3 
4 
5 
6 
7 



Unlimited 
1000 8 
5000 8 
50000 



8 



100000 8 
200000 8 
400000 8 
Unlimited 



CTct 



Control point time slice in seconds. This parameter specifies the 
maximum amount of time that a job of the specified priority can 
remain at a control point before its priority is changed to the control 
point slice priority (cp). ct ranges from 1 to 7777 8 . 
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Parameter 



Description 



DSds 



Size in PRUs allowed for individual direct access permanent files, ds 
indicates the limit value for the size of the files. 



ds 


Limit Value 





Unlimited 


1 


lOOOg 


2 


5000 8 


3 


50000 8 


4 


100000 8 


5 


200000 8 


6 


400000 8 


7 


Unlimited 



DTsc 
ECec 



EMem 



Service class to which a detached job is assigned if the job is detached. 
The default value for sc is DI (detached interactive). 

Maximum user-accessible extended memory field length in words 
divided by UEBS 20 for any job of the specified service class. This 
parameter performs the same function for extended memory field 
length that the FL parameter does for central memory field length, ec 
ranges from to 3777 8 . 

Maximum extended memory length in words divided by UEBS 19 for all 
jobs of the specified service class. This parameter performs the same 
function for extended memory field length that the AM parameter does 
for central memory field length, em ranges from to 3777 8 . 



20. Refer to Extended Memory Overview earlier in this section to determine the value of UEBS. 
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IPRDECK 



Parameter Description 



FCfc Number of permanent files allowed, fc indicates a limit value that is 

the maximum number of permanent files allowed. 



fc 


Limit Value 





Unlimited 


1 


10 8 


2 


40 8 


3 


100 8 


4 


200 8 


5 


1000 8 


6 


4000 8 


7 


Unlimited 



FLfl Maximum field length divided by 100 8 for any job of the specified 

service class. If more memory is requested, the job is aborted. You 
typically use this parameter to limit the memory requirement for jobs 
of a specific service class during certain hours of the day. For example, 
you may use the FL parameter to specify a maximum field length for 
all batch service class jobs between the hours of 2 p.m. and 4 p.m. fl 
ranges from to 7777 8 . 

FSfs Size in PRUs allowed for individual indirect access permanent files, fs 

indicates a limit value for the size of the files. 



fs 


Limit Value 


n 


Unlimited 


l 


10 8 


2 


30 8 


3 


100 8 


4 


300 8 


5 


1000 8 


6 


2000 8 


7 


Unlimited 
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Parameter 



Description 



NJnj 
PRprS 

RSrs 



SEse 



TDtd 



TPtp 



USus 



Maximum number of jobs. For each service, this parameter specifies 
the number of jobs that can be executing in the system, nj ranges from 
to 7777 8 . 

CPU priority. When more than one job is waiting for the CPU, the jobs 
with the highest CPU priority access the CPU first. Jobs with lower 
CPU priority access the CPU only when higher-priority jobs no longer 
wish to use the CPU. pr ranges from 2 to 77 8 . 

Recall CPU slice in milliseconds. The minimum guaranteed amount of 
time that a recalled job keeps the CPU before it can be preempted by 
another recalled job at the same CPU priority, rs ranges from 1 to 
7777 8 , but the value specified must be less than or equal to the value 
specified for the unextended CPU slice, us. 

CPU slice extension in milliseconds. The maximum additional amount 
of CPU time that a job performing I/O gets after its unextended CPU 
slice expires before the CPU slice expires (and the CPU is switched to 
an equal-priority job). This is the maximum extension. The slice is 
actually extended from the amount already used by the value of the 
recall CPU slice, rs, each time that the job is recalled, se ranges from 
to 7777 8 . 

Suspension time-out delay. A suspended job will not be timed out for 
td*10 8 seconds. The maximum delay is approximately 9 hours, td 
ranges from to 7777 8 . 

Terminal job priority assigned to a term in al job that is rolled out 
waiting for terminal input, tp ranges from to 7777 8 , but must be in 
the range of values for the execution queue parameters lp and up (refer 
to the QUEUE command LP and UP parameters). 

Unextended CPU slice in milliseconds. The amount of CPU time that a 
CPU-bound job gets before the CPU is switched to an equal-priority 
job. us ranges from 1 to 7777 8 , but the value specified for us must be 
greater than or equal to the value specified for the recall CPU slice, rs. 
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IPEDECK 

SPINDOWN 

Formats: 

ENABLE, SPINDOWN. 
DISABLE , SPINDOWN . 

Default: 

Enabled. 

Significance: 

These entries enable or disable the spindown of 834, 836, 887, and 9853 disk units. 
When spindown is enabled, entering a CHECK POINT SYSTEM command will cause 
all 834, 836, 887, and 9853 disk units that are on and not globally unloaded to 
automatically spin down. When spindown is disabled, entering a CHECK POINT 
SYSTEM command will not spin down the 834, 836, 887, and 9853 disk units. System 
checkpoints that are initiated by mainframe errors do not affect the state of these disk 
units. 

SRST 

Format: 

SRST=n. 
Default: 



Significance: 

This entry specifies the secondary rollout sector threshold. Any rollout file smaller than 
n sectors (0 < n < 7777 8 ) is considered a secondary rollout file for the purpose of 
equipment selection. 

NOTE 

The size of the rollout file for any job must be at least seven sectors larger than the 
combined size in sectors of the job's central memory and extended memory field lengths. 
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SYSTEM DEBUG 

Formats: 

ENABLE, SYSTEM DEBUG. 
DISABLE, SYSTEM DEBUG. 

Default: 

Disabled. 

Significance: 

These entries enable or disable the system debug mode of operation. When the system 
is in system debug mode, it is less tolerant of system errors; that is, it is more likely to 
hang upon experiencing errors. When the system is not in system debug mode, it rates 
system errors as critical or noncritical. For critical errors, the system partially or 
totally interrupts system operation to tend to the errors. For noncritical errors, the 
system logs them in the binary maintenance log (BML) and inasmuch as possible allows 
system operation to proceed. You can initiate the system debug mode with the DSD 
ENABLE command or the corresponding IPRDECK entry. 

There is another system state called debug mode, which is conceptually different from 
that of system debug mode. Debug mode is the state of the system where a user with 
system origin privileges can make modifications to the running system. You can initiate 
this mode of operation with the DSD command DEBUG. The left screen header of the 
system console indicates whether the system is in debug mode or not. 
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TAPE PF STAGING 

Formats: 

ENABLE, TAPE PF STAGING. 
DISABLE, TAPE PF STAGING. 

Default: 

Disabled. 

Significance: 

These entries specify whether permanent files that reside on 9-track and CTS tape 
alternate storage are staged to disk. If disabled, jobs that attempt to access permanent 
files residing only on 9-track tapes or CTS tapes are aborted. Contrast this entry with 
the ACS TAPE PF STAGING entry, which controls staging from ACS tapes, and the 
CARTRIDGE PF STAGING entry, which controls staging from MSE or optical disk. 

UNLOCK 

Format: 

UNLOCK. 

Default: 

Unlocked. 

Significance: 

This entry specifies the system console is unlocked. All DSD commands can be entered 
when the console is unlocked. The console is usually locked when the system is being 
used in a production environment. Refer to LOCK earlier in this section. 

USER EXTENDED MEMORY 

Formats: 

ENABLE, USER EXTENDED MEMORY. 
DISABLE, USER EXTENDED MEMORY. 

Default: 

Disabled. 
Significance: 

These entries enable or disable scheduling of jobs that access user extended memory. 
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LIBDECK 

LIBDECK is a SYSEDIT directive record on the deadstart file. SYSEDIT reads LIBDECK 
during the system load. LIBDECK specifies program residence, field length, record type, 
and parameter format. 

Up to 64 LIBDECK records can be placed on the deadstart file. LIBDECKs are named 
LIBDnn, where nn is 00 to 77 8 . A specific record can be selected with a LIB=n entry in 
CMRDECK The multiple deadstart deck capability enables the use of a single deadstart file 
on virtually any system configuration. 

You can list all LIBDECKs on the deadstart file by accessing the system file SYSTEM with a 
COMMON command, then using the T parameter on the CATALOG command. Refer to the 
NOS Version 2 Reference Set, Volume 3 for more information concerning these commands. 

The following fist provides brief descriptions of SYSEDIT directives acceptable in 
LIBDECK Complete descriptions of all SYSEDIT directives are in section 19, SYSEDIT. A 
list of valid record types follows the directives. 



Directive Format 



Significance 



i= AD,nn,ty 1 /rec 1 ,ty 2 /rec 2 ,...,ty n /rec n 



frCM^/rec^ty^r^.^tyj/reCjj 



*FL,ty 1 /rec 1 -n 1 ,ty 2 /rec 2 -n 2 ,..., 
Wrevfln 

*MS,ty 1 /rec 1 ,ty 2 /rec 2 ,...,ty n /rec I] 



Specifies the alternate device to be used 
in addition to the system device(s) for 
storing ABS, OVL, PP, and REL type 
records, nn is either the EST ordinal or 
the equipment type, tyj is the record 
type, and recj is the record name. 

Defines record recj of type tVj as being 
central memory resident; valid only for 
record types ABS, OVL, or PP. Like 
any other job in NOS, SYSEDIT has a 
field length restriction of 376000 8 
central memory words. You cannot use 
more than approximately 326000 8 
central memory words (376000 8 -50000 8 
words for SYSEDIT's program FL) 
when defining records to be central 
memory resident. 

Record recj of type ty 4 is loaded with a 
field length specified by flj (flj is field 
length divided by 100 8 ). 

Defines record recj of type tVj as being 
mass storage resident. This is the 
default residence for routines with no 
storage area specified in LIBDECK 
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LIBDECK 



Directive Format 



Significance 



*PROC,rec 1 ,rec 2 ,...,rec n 

*SC,ty 1 /rec 1 ,ty 2 /rec 2 ,..., 

tyn /rec n 



*/ comments 



Defines record req of type PROC as a 
procedure file. 

Defines record recj of type ty-j as 
product set format commands. The 
command parameters are processed in 
product set format (refer to the NOS 
Version 2 Reference Set, Volume 3). 

Defines comment lines. 



The following record types may be specified in SYSEDIT directives. Some directives do not 
allow all types. 

Type (ty { ) Description 

ABS Multiple entry point overlay. 

CAP Fast dynamic load capsule. 

OPL Modify old program library deck. 

OPLC Modify old program library common deck. 

OPLD Modify old program library directory. 

OVL Central processor overlay. 

PP 12-bit peripheral processor program. 

PPL 16-bit peripheral processor program (CYBER 180 models only). 

PPU First-level peripheral processor (FLPP) program (model 176 only). 

PROC Procedure. 

REL Relocatable central processor program. 

TEXT Unrecognizable as one of the other types. 

ULIB User library program. 
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DIS Job Dayfile Display (A) 4-3 

DIS Job Status Display (B) 4-4 

DIS Memory Displays (C, D, F, G) 4-6 

DIS Exchange Package Display (X) 4-8 

DIS Directory Display (Z) 4-9 

Console Operation 4-10 

Display Selection Commands 4-13 

DIS Keyboard Entries 4-14 

Memory Entry Commands 4-18 

PP Call Commands 4-20 
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DIS displays information about a single job. Under DIS, the X display shows the exchange 
package area for the job. Central memory addresses relative to the job's reference address 
are used for the data and program displays. 

Initiate DIS at a control point to monitor the progress of a job by using any of the following 
methods: 

• You can call DIS by entering X.DIS,fl (fl=field length desired) or X.DIS (field length of 
60000 8 assumed by default). This brings DIS to an empty control point to initiate 
utility programs. 

• A job can execute a command in the form DIS (the job must be system origin or have 
system origin privileges). 

• You can call DIS to an existing job by entering the command: 

DIS, jsn. 

Parameter Description 

jsn Job sequence name to which you want DIS assigned. 

On either a secured or unsecured system, before you can call DIS to an existing job, the 
console must be unlocked (refer to the DSD UNLOCK command in section 5). For a secured 
system, the system must be set to security unlock status by the security administrator. 

You can toggle between DSD and DIS. DIS permanently returns control to DSD when you 
enter DROP.; the job is not dropped unless no commands remain. 

When DIS is called to a control point, automatic command processing stops and the A and B 
displays for DIS appear on the left and right display screens, respectively. Keyboard entry 
is necessary to begin processing subsequent commands. Unless automatic command 
processing is reenabled, 1 the job is stopped after each command is processed. That is, only 
one command can be processed at a time. Under DIS, the B display shows only the 
condition of the job to which it is assigned, including upcoming commands. When the job is 
not using the central processor, a copy of its exchange package is displayed on the X 
display. Displays available under DIS are selected in the same manner as DSD displays. 
Refer to Console Operation later in this section for information concerning display selection 
commands and to DIS Keyboard Entries for information about other DIS commands. 



1. You can initiate automatic command processing by entering either a period (.) or the RCS command (refer to Console 
Operation and to DIS Keyboard Entries later in this section). 
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The displays available under DIS are: 

Display 

Identifier Description 



A Job dayfile. Messages and files (local FNT entries) attached to the job. 

B Job status. Individual job status, equipment assigned, current 

messages, and command buffer. 

C,D Central memory. Contents of central memory words (selectable 8-word 

groups) in five columns of four octal digits with display code 
equivalents (same as the DSD C and D displays). 

F Central memory. Contents of central memory words (selectable 8-word 

groups) in four columns of five octal digits with display code 
equivalents. 

G Central memory. Contents of central memory words (selectable 8-word 

groups) in four columns of five octal digits with COMPASS instruction 
mnemoric equivalents. 

H File status. All files assigned to the job as well as equipment assigned 

to files. 

M Extended memory. Contents of 60-bit words of extended memory 

(selectable 8-word groups) in five columns of four octal digits with 
display code equivalents (same as the DSD M display). 

N Blank screen. You may wish to select the N display or one screen to 

reduce the screen filter on the other screen. 

T,U Text display. Displays text from central memory in coded lines (up to 

60 characters per line). The display terminates after 256 words have 
been displayed. 

V Central memory buffer. Displays directly from central memory. The 
display terminates after 512 words have been displayed. 

X Exchange package. Breakpoint address and the exchange package. 

Y Monitor functions. Displays mnemonics and the values of all monitor 
functions (same as the DSD Y display). 

Z Directory. DIS displays available. 

NOTE 

Although all displays listed may appear on the left screen, only the B, 
C, D, and N displays may appear on the right screen. If you attempt to 
bring any other display to the right screen, the message INCORRECT 
COMMAND is issued to the job dayfile and is displayed in the message 
buffer of the B display. 
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DIS Job Dayfile Display (A) 

Figure 4-1 shows the DIS job dayfile display (A). The figure shows the job dayfile messages 
for the control point to which DIS is currently assigned and as many files attached to that 
control point as will fit in the display. All files attached to the job can be observed by using 
the file status display (H). 





DIS A. JOB DAYFILE. 








89.46. 34. RFUOeOOOO) 
09.46. 34. MS. 
Q9.47.31.USER.ABC1234,. 
09.47. 31-ABSC. S. 






Dayfile 


09-48. 43.PACKNAM. 72 1C.R-OL. 






H9558QBS ' 


09. 49.39. NOS. 

09.50.06. eET.NOS/WWAOCC.IWW.UNIlKOtiOD 

09.50.06. DEVICE UNMAILABLE- 

09.50.29. EXIT. 

09.50.41. 6ET,lOS/PN»PACltW2.R=DJ,UN>*RCWM0D 

09.50.41. DEVICE UWVAILABLE. 

09.55.41. COMMON. SYSTEM. 








FNT NAME TYPE EST TRACK FS STATUS 


LEVEL 






INPUT* 1N> 7 4004 NP 5 


LVL0 


Files (local no 




5 SYSTEM LI* 6 4010 1 


LVL0 


entries) attached 




10 ZZZZZCO LI' 7 4213 ND 5 


LVL0 


to the job 




11 ZZZZZC2 U> 6 5652 ND 307 


LVL0 





Figure 4-1. DIS Job Dayfile Display (A) 

The level field, shown in the figure, is displayed only on a secured system. 
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DIS Job Status Display (B) 



DIS Job Status Display (B) 

The DIS B display shows the status of a specific job executing at a control point. It also 
shows: any equipment assigned exclusively to the job by EST ordinal, message 1 and 
message 2 from the control point area, and the current command buffer, allowing you to 
anticipate future job requirements. 

Figure 4-2 shows the DIS job status display (B). 



DIS B. JOB STATUS. 












JSN = AAAC EJTO 


_ 


5 P 


_ 


2046 


1 


SRUA 


= 


1 RA 


= 


1741 


1 


UI = 2755 SRUL 


= 


777777 FL 


= 


26 


\ Job status 


FM = MLSTEST CS 


= 


BATCH RAE 


= 


160 




PN = 72 1C CONN 


= 


FLE 


= 







LEVEL 


= 


LVLO CPA 


= 


600 




CPU = X 












EST = 1 


} 


Equipment assigned 






J 


MSI = DEVICE UNAVAILABLE. 


1 










MS2 = 


J 


Current messages 








NOS,PACKV2. 


1 








RETURN, NOS. 












REVERT, NOLI ST. 












EXIT. 












REVERT, ABORT. PACKC OR PACKV2 


NOT FOUND. \ Command 


buffer 




REVERT, NOLI ST. 












EXIT. 












REVERT. CCL 












EXIT . CCL 












REVERT , ABORT . CCL 




J 









Figure 4-2. DIS Job Status Display (B) 
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The job status portion of the display shows three columns of information. Each item has the 
form item=value. The items are described next in the order that they appear on the display. 



Item 



JSN 

UI 

FM 

PN 

CPU 

EJTO 

SRUA 

SRUL 

CS 

CONN 

LEVEL 

P 

RA 

FL 

RAE 

FLE 

CPA 



Description 



Job sequence name of the DIS job. 

User index. 

Current family name. 

Current pack name. 

CPU status. 

Executing job table ordinal. 

System resource units accumulator. 

Account block limit for system resource units. 

Connection status. 

Connection number (interactive jobs only). 

Job access level (secured systems only). 

P register address from exchange package. 

Central memory reference address. 

Central memory field length. 

Extended memory reference address. 

Extended memory field length. 

Control point area address. 
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DIS Memory Displays (C, D, F, G) 

Figure 4-3 shows the DIS data storage display (F). The contents of each central memory 
word is displayed in columns of five octal digits along with the display code equivalent. 
Only the memory locations currently assigned to the job can be displayed. The message 
****SECURED AREA**** is displayed for all other locations. 

The DIS C and D displays have the same format as the DSD C display, except that the DIS 
memory displays may show a managed table bias word preceding the groups of central 
memory words. 



DIS F. CENTRAL 


MEMORY. 






00000060 


00000 


00000 


ooooo 


ooooo 




00000061 


00000 


00000 


ooooo 


ooooo 




00000062 


00000 


ooooo 


ooooo 


ooooo 




00000063 


00000 


00000 


ooooo 


ooooo 




00000064 


03171 


51517 


16000 


00001 


COMMON A 


00000065 


40000 


00000 


00010 


00507 


5 A EG 


00000066 


40000 


00000 


00020 


00131 


5 B AY 


00000067 


40000 


ooooo 


ooooo 


ooooo 


5 


00000070 


03171 


51517 


16562 


33123 


COMMON, SYS 


00000071 


24051 


55700 


ooooo 


ooooo 


TEM. 


00000072 


00000 


ooooo 


ooooo 


ooooo 




00000073 


00000 


ooooo 


ooooo 


ooooo 




00000074 


00000 


ooooo 


ooooo 


ooooo 




00000075 


00000 


ooooo 


ooooo 


ooooo 




00000076 


00000 


ooooo 


ooooo 


ooooo 




00000077 


00000 


ooooo 


ooooo 


ooooo 





Figure 4-3. DIS Data Storage Display (F) 
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Figure 4-4 shows the DIS program storage display (G). The G display shows the contents of 
central memory and the COMPASS mnemonic translation. 



DIS 6. CENTRAL MEMORY. 



00000000 


00000 00000 00000 00000 


PS 




PS 


00000001 


05160 42000 00000 00000 


NE 8B 




PS 


00000002 


23312 32405 15000 00001 


AX XB 


DXX+X 


BXX*-X PS 


00000003 


00000 00000 00000 00000 


PS 




PS 


00000004 


00000 00000 00000 00000 


PS 




PS 


00000005 


00000 00000 00000 00000 


PS 




PS 


00000006 


00000 00000 00000 00000 


PS 




PS 


00000007 


00000 00000 00000 00000 


PS 




PS 


00000010 


00000 00000 00000 00000 


PS 




PS 


00000011 


00000 00000 00000 00000 


PS 




PS 


00000012 


00000 00000 00000 00000 


PS 




PS 


00000033 


00000 00000 00000 00000 


PS 




PS 


00000014 


00000 00000 00000 00000 


PS 




PS 


00000015 


00000 00000 00000 00000 


PS 




PS 


00000016 


00000 00000 00000 00000 


PS 




PS 


00000017 


00000 00000 00000 00000 


PS 




PS 


Address 


memory 


COMPASS M 


leaontc 




contents 




translation 



Figure 4-4. DIS Program Storage Display (G) 
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DIS Exchange Package Display (X) 

The DIS X display shows the breakpoint address (BKP=addr) if a breakpoint was set at 
address addr. The breakpoint address is followed by the job's exchange package. 

Figure 4-5 shows the DIS exchange package display (X). 



DIS X. 


EXCHANGE PACKAGE. 






BKP 


100. 








P 


— 


452 


A0 = 


600 


B0 = 


RA 


174100 


Al = 


1 


Bl = 1 


FL 


= 


600 


A2 = 





B2 = 777776 


EM 


= 74070000 


A3 = 





B3 = 1 


RAE 


= 





A4 = 





B4 = 3 


FLE 


= 





A5 = 


2 


B5 = 1 


MA 


= 


600 


A6 = 


1 


B6 = 


EEA 


= 





A7 = 


375 


B7 = 


XO = 


7777 


7777 


7777 7700 


0000 




XI = 


0000 


0000 


0000 0000 


0000 




X2 = 


0000 


0000 


0000 0000 


0375 


C 


X3 = 


0000 


0000 


0000 0000 


0000 




X4 = 


0000 


0000 


0000 0000 


0003 


C 


X5 = 


2331 


2324 


0515 0000 


0001 


SYSTEM A 


X6 = 


0516 


0420 


0000 0000 


0000 


ENDP 


X7 = 


0000 


0000 


0000 0000 


0000 




+ AND - WILL SET *BKP* TO (P) +/- 1. 



Figure 4-5. DIS Exchange Package Display (X) 
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DIS Directory Display (Z) 

Figure 4-6 shows the DIS directory display (Z). The Z display lists all displays available 
tinder DIS control. If the letter entered to select the left screen display is not a valid display 
identifier, the Z display is selected automatically. 



DIS Z 


DIRECTORY. LEFT SCREEN ONLY DISPLAY 




A 


JOB DAYFILE. 




F 


CENTRAL MEMORY. FOUR GROUPS OF FIVE. 




G 


CENTRAL MEMORY. FOUR GROUPS OF FIVE. 




H 


FILE STATUS. 




M 


EXTENDED MEMORY. 




T 


TEXT DISPLAY. 




U 


TEXT DISPLAY. 




V 


CM BUFFER. 




X 


EXCHANGE PACKAGE. 




Y 


MONITOR FUNCTIONS. 




Z 


DIRECTORY. 




LEFT AND RIGHT SCREEN DISPLAYS 




B 


JOB STATUS. 




C 


CENTRAL MEMORY. FIVE GROUPS OF FOUR. 




D 


CENTRAL MEMORY. FIVE GROUPS OF FOUR. 




N 


BLANK SCREEN. 



Figure 4-6. DIS Directory Display (Z) 
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Console Operation 

Unlike DSD, DIS is not interpretive. You must complete every entry and signal DIS to act 
upon the message by pressing CR or NEXT. The following rules apply to all DIS commands. 

• For input, spaces in an octal field are ignored but can be inserted for readability. 

• For output, all octal fields are right-justified with leading zero fill; excess octal digits 
are ignored. 

In addition to the command entries, the following keys have special meaning to DIS when 
entered as the first character. The corresponding special keys for the CC545, CC598B, and 
CC634B console types are listed along with a description of the use of each key. 

CC545 CC598B CC634B Description 

* * F15 If DSD has relinquished the main display 

console to DIS, this key acts as a quick hold, 
and DIS drops the display channel so that DSD 
can use it. 

+ Up arrow, +, + Pages the left screen forward for the A, C, D, F, 

or grey + G, H, M, T, and U displays. Increments the 

breakpoint address for the X display. 

- Down arrow, - Pages the left screen backward for the C, D, F, 

-, or grey - G, M, T, and U displays. Decrements the 

breakpoint address for the X display. Resets 
the H display to the beginning. On the A 
display, the - converts to a BEGIN,. 

( PgUp or ( ( Pages the right screen forward for the C and D 

displays. 

) PgDn or ) ) Pages the right screen backward for the C and 

D displays. 

Ill Advances the left screen memory display 

address by the value in the lower 18 bits of the 
first word displayed (applicable only to memory 
displays C, D, F, G, and M). 

Sets auto mode (initiates automatic command 
processing). This key performs the same 
function as the RCS command described under 
DIS Keyboard Entries later in this section. 



4-10 NOS Version 2 Analysis Handbook 60459300 U 



Console Operation 



CC545 



CC598B 



CC634B Description 



8 



Eight blank 
(display key) 



CR (carriage 
return) 



Tab 



Enter/Return NEXT 



Advances the pointer indicating the first 
address of managed tables for the left screen 
(applicable only to memory displays C, D, F, 
andG). 

Decrements the pointer indicating the first 
address of managed tables for the left screen 
(applicable only to memory displays C, D, F, 
andG). 

Advances the left screen display sequence 
established by the SET,screen. command (refer 
to Display Selection Commands later in this 
section). 

Sets the repeat entry flag; the message 
REPEAT ENTRY is displayed on the error 
message line of the left screen. The subsequent 
command entry is processed but is not erased 
after completion. That command is processed 
each time this key is pressed. To clear the 
repeat entry mode, press the left blank (erase) 
key on the CC545 or the «- key on the CC634B. 



The following keys are interpreted as control characters by DIS. 



CC545 



CC598B 



CC634B Description 



Left blank 
(erase) 


Esc 


<— or 
ERASE 


BKSP 
(backspace) 


Back Space 


< — 


CR (carriage 
return) 


Enter/Return 


NEXT 



Clears current DIS keyboard entry and any 
resultant error message; auto mode (automatic 
command processing) is also cleared. 

Deletes last character displayed and clears error 
message (if one exists). 

Initiates processing of an entered command. 



The following keyboard messages may appear above your entry. 



Description 



AUTO MODE. 



COMMAND BUFFER 
FULL. 

COMMAND TOO 
LONG. 



The command buffer is read automatically. Automatic command 
processing can be selected by the RCS command or by entering a 
period. 

The ELS command has been entered and there is insufficient 
room in the command buffer to add the characters requested. 

The command you entered is too long. 
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Message 



Description 



COMMANDS ON 
FILE. 

DIRECT CPU INPUT. 

DISK BUSY. 

EXTENDED 
MEMORY NOT 
AVAILABLE. 

INCORRECT ENTRY. 

INCORRECT FL 
REQUEST. 

INCORRECT 
PRIORITY. 

INSUFFICIENT 
FIELD LENGTH. 

JOB ACTTVE. 

OUT OF RANGE. 
PP BUSY. 

REPEAT ENTRY. 



REQUEST EXCEEDS 
MAXIMUM FLE. 

STORAGE NOT 
AVAILABLE. 

WAITING FOR 

EXTENDED 

MEMORY. 

WAITING FOR 
STORAGE. 



The ELS command has been entered and commands are 
currently located in a file instead of in a command buffer. It is 
not possible to add a command to the file. 

The N command has been entered and all data entered from the 
keyboard is being passed directly to central memory. 

DIS is waiting for an overlay to be loaded from a mass storage 
device. 

You entered the ENFLE command, but user extended memory is 
not defined. 

The command cannot be processed. 

You entered an ENFL command to set the field length. The 
requested field length must be greater than 10000 8 and less 
than 377700 8 including negative field length. 

The priority you entered using the ENPR command is not 
correct. CPU priority must be greater than 1 and less than 71 8 . 

Your field length is not long enough to support either extended 
memory or 026. 

The previous request has not completed. The command must be 
reentered when the job is not active. 

The memory entry address is greater than the field length. 

DIS is waiting for a PP to be assigned in order to process a 
keyboard entry. 

The command in the command buffer is repeated each time you 
press CR, Enter/Return, or NEXT. This can be cleared by 
pressing the left blank, Esc, or <- key. 

You requested more extended memory than your system can 
support. 

The amount of central memory requested by the ENFL 
command or required by the 026 file editor is not available. 

DIS is waiting for extended memory after you entered the 
ENFLE command. 

DIS is waiting for central memory after you entered the ENFL 
or 026 command. 
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Display Selection Commands 

Specify the displays you want shown on the console's left and right screens by using the 
following commands. Follow the entry with a carriage return. 

C omman d Description 



xy. Brings the x and y displays to the left and right screens, respectively. 

Note that although all DIS displays may appear on the left console screen, 
only the B, C, D, and N displays may appear on the right screen. If you 
attempt to bring any other display to the right screen, the entry is 
interpreted as a command and the message INCORRECT ENTRY 
appears. In addition, if the letter entered to select the left screen display 
(x) is not a valid display identifier, the Z display is selected automatically. 

xz,loc. Brings specified memory display to the left screen, if not currently 

selected, and provides display modifications as follows: 

Parameter Description 

x Display identifier (C, D, F, G, or M). 

z Type of display modifications: 0-3, 4, 5, or 6 

Use 0-3 to display specified group (8 words) starting at 
location loc. 

Use 4 to display all 8-word groups in contiguous locations 
starting at location loc. 

Use 5 to advance the display by loc locations. 

Use 6 to decrement the display by loc locations. 

loc Location parameter (maximum of eight digits for central 

memory address or seven digits for extended memory 
address). 

x,addr. If x specifies one of the memory displays (C, D, F, G, or M), addr is the 

address used to obtain the bias address for the managed table display. 
(The bias address is the lower 18 bits of the word at addr.) 

SET,xxxx. Sets the left screen display sequence; xxxx consists of one to four display 
identifiers. Pressing the right blank key on the CC545, the Tab key on the 
CC598B, or the -» key on the CC634B after this command is entered 
causes the first display to appear on the left console screen. Pressing the 
key again selects the second display. The next display in the specified 
sequence appears on the left screen each time the key is pressed, for 
example, SET,ACFD. 
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DIS Keyboard Entries 

You can enter the following commands while in DIS. 

If a job is currently active (CPU active, waiting, on recall, or PP active), many commands 
are not accepted and the message JOB ACTTVE is displayed. 



C omman d 



Description 



BEGIN,pname,pfile. 
BKP,addr. 

BKPA,addr. 



CEF. 

DCP. 

DDF. 

DIS. 

DROP. 

ELS.commandstring. 

ENAi,addr. 
ENBi,addr. 
ENEM,n. 
ENFL,fl. 



Sets auto mode and calls the procedure pname that is on file pfile. 

Breakpoint to address addr in the program. Central processor 
execution begins at the current value of P and stops when 
P=addr, and DIS is the only PP active at the control point. 

Breakpoint to address addr in the program with assigned PPs. 
Central processor execution begins at the current value of P and 
stops when P=addr. PPs attached to the control point can still be 
active. DIS clears addr to stop the program at that point. The 
breakpoint may be cleared by setting the breakpoint address to a 
new value. 

Clears the skip-to-exit flag. This allows command processing to 
continue with the next command instead of skipping to the EXIT 
command after an error. 

Drops the central processor and displays the exchange package 
area on the X display. 

Calls the display disk file (DDF) utility to the control point. 

Reloads the main DIS overlay. 

Drops DIS, but normal processing of the job continues (it does not 
drop the job until all commands are processed). 

Allows entry of the commandstring command after the last 
command in the command buffer, if there is space. This command 
is valid only when auto mode is not set. 

Sets register Ai=addr in the exchange package area. 

Sets register Bi=addr in the exchange package area. 

Sets CPU program exit mode to n (0 < n < 7). 

Sets central memory field length FL=fl in the exchange package 
area (0 < fl < 777777 8 ). fl must be at least 10000 8 if user extended 
memory is assigned. 
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Command 



Description 



ENFLE,fle. 



ENP,addr. 

ENPR,pr. 

ENPR,*. 



ENS.commandstring. 



ENTER./commandl/ 
commands. 

ENTL,timlrnt. 

ENXi,cont. 

ENXi,Lcont. 

ENXi,Dcharacters. 

ENXi,b,value. 

ERR. 

GO. 
HOLD. 

M.characters. 
N.characters. 



Sets extended memory field length FLE to fleOOO in the exchange 
package area (1 < fie < 7777 8 ). If user extended memory is 
assigned (fle=0), central memory FL, set by the ENFL command, 
must be greater than or equal to 10OOO 8 . 

Sets P=addr (next instruction address). 

Sets the CPU priority to pr (2 < pr < 67 8 ). 

Sets the CPU priority to the value defined for the job's service 
class. 

Allows entry of the commandstring command as the next 
unprocessed command in the command buffer. The command can 
then be processed using RNS, RSS, or DROP. Use of ENS with 
CCL procedure files produces unexpected results. This command 
is valid only when auto mode is not set. 

Allows entry of the commandl and command2 commands from 
the keyboard and sets auto mode. 

Sets the job time limit to timlmt (77777 8 specifies no limit). 

Sets register Xi=cont in the exchange package area. 

Sets register Xi=cont, left-justified, in the exchange package area. 

Sets register Xi to characters in display code. 

Sets byte b of register Xi to value. 

Sets forced error flag (FSE), terminates program execution, and 
clears auto mode if set. 

Restarts a program that has paused. 

DIS relinquishes the display console, but the job is held at the 
present status. The console must be reassigned to continue use of 
DIS. 

Enters characters as a CPU program command. Data is stored at 
RA+CCDR. 

Sets direct CPU input mode. Characters entered from keyboard 
are passed one character at a time, right-justified, directly into 
central memory at RA+CCDR. Pressing the left blank key on the 
CC545, the Esc key twice on the CC598B, or the <- key twice on 
the CC634B clears direct CPU input mode. 
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Co mman d 



Description 



OFFSWs. 

ONSWs. 

026. 

RCP. 

RCS. 



RNS. 
ROLLOUT. 

ROLLOUT,spr. 

RSS. 

RSS,commandstring. 

SCS. 
SUI,userindex. 

T,addr. 



Turns off sense switch s for the job (1 < s < 6). 

Sets sense switch s for the job (1 < s < 6). 

Calls the 026 file editor to a control point. Refer to the NOS 
Version 2 Systems Programmer's Instant for a description of the 
editing commands. 

Requests central processor. Depending on job priority, execution 
begins at the next program address for a job suspended by a DCP 
request. 

Sets auto mode, which initiates automatic command processing. 
All succeeding commands are read from the command buffer and 
processed automatically until an SCS command, an erase 
function, or an error is encountered. A period (.) may also be used 
to initiate automatic command processing. 

Reads and processes the next command in the DIS command 
buffer. 

Allows the job to roll out. This command should be issued when 
the message ROLLOUT REQUESTED appears (or the * or F15 
key may be used). 

Places job in rollout status for spr job scheduler delay intervals. 
The job is automatically rolled back in after this period of time. If 
a number greater than 777 g is specified for spr, 777 8 is used. 

Reads the next command from the command buffer and stops 
prior to CPU execution. This is used to initiate breakpointing of a 
program. 

Reads the commandstring command and stops prior to execution. 
The action is similar to ENS followed by RSS except that the 
command buffer is not cleared. 

Clears auto mode, which stops automatic command processing. 

Allows access to a user index above AUEMX (377700 8 ). Any 
permanent file activity that is to be done on such user indices 
must be done through system origin jobs. This command is not 
accepted by a secured system. 

Changes the T display to start at address addr. 
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Command 



Description 



U,addr. 
UCC=c 

V,addr. 

X. commandstring. 

* commandstring. 



commandstring. 



Changes the U display to start at address addr. 

Sets the uppercase character c. This command does not terminate 
with a period. 

Changes the V display to start at address addr. 

Processes commandstring as the next command. Only the first 50 
characters following X are used. This may be used to enter a 
leading slant or a command that is the same as DIS display. 

If an asterisk (*) followed by a blank and commandstring is 
encountered during automatic command processing (auto mode), 
commandstring is interpreted as a direct DIS display selection 
command. For example, * C4,100. will set the left screen display 
to the central memory C display at address 100. Using this 
feature, it is possible to set up procedure files that use DIS to 
breakpoint a program to a desired stopping point. 

Processes commandstring as a command if it is not a recognizable 
DIS command. 

Calls the 026 file editor to a control point. Refer to the NOS 
Version 2 Systems Programmer's Instant for a description of the 
editing commands. (This command is the same as the 
026 command.) 
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Memory Entry Commands 

The following commands are used in conjunction with the C, D, F, G, and M memory 
displays to change the contents of central memory and extended memory. Only locations 
relative to the reference address (RA) of the job to which DIS is assigned can be changed. 
When changing the contents of memory relative to a job, the negative field length area of 
the job can be accessed by specifying a negative address. For example, to change the 
content of RA-3, enter the address 777775 8 . 

On a secured system no memory entry commands are allowed unless the security unlock 
status is set. The memory display shows the message 

****SECURED AREA**** 

instead of the contents of the memory locations to prevent you from examining these 
locations; you may not alter the contents of these locations. 

Character values or numeric data can replace the current word contents. Either one 12-bit 
byte, one 15-bit parcel, one 30-bit parcel, or 60 bits can be changed. A single byte can be 
changed by inserting the byte number after the location to be changed; bytes are numbered 
through 4 from left to right. The address and contents are assembled right-justified with 
leading zero fill. Leading zeros may be omitted in the entry. Only words within the field 
length of the job may be changed. 

CAUTION 

Improper use of these commands may result in damage to the system or to user jobs. 

Formats and descriptions of the memory entry commands follow. 

Command Description 

addr,cont. Changes the contents of memory location addr to cont. The 

or second form of the command performs essentially the same 

addr+cont. function but leaves the address at addr+1, allowing immediate 

entry for the next memory location. 2 

addr,b,cont. Changes the contents of byte b at memory location addr (eight 

or digits) to cont. Each location consists of five 12-bit bytes, 

addr+b,cont. numbered through 4 from left to right. The contents are octal 

characters. The second form of the command performs essentially 
the same function but leaves the address at addr+1, allowing 
immediate entry for the next memory location. 2 



2. If the message REPEAT ENTRY is displayed above the entry line, the cont field is not cleared and may be entered in successive 
memory locations as many times as desired by pressing CR or NEXT. The repeat entry mode is enabled by pressing CR or NEXT 
before initial entry of the command. This is also applicable to the b and n fields of the second, fifth, and seventh commands. 
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Command 



Description 



addr,Dcont. 

or 

addr+Dcont. 



addr,Lcont. 

or 

addr+Lcont. 

addr,In,cont. 

or 

addr+In,cont. 



Eaddr,cont. 

or 

Eaddr+cont. 

Eaddr,b,cont. 

or 

Eaddr+b,cont. 



Eaddr,Dcont. 

or 

Eaddr+Dcont. 



Changes the contents of memory location addr (eight digits) to 
display code characters cont (left-justified and zero-filled). The 
second form of the command performs essentially the same 
function but leaves the address at addr+1, allowing immediate 
entry for the next memory location. 3 

Changes the contents of memory location addr (eight digits) to 
left-justified cont. The second form of the command performs 
essentially the same function but leaves the address at addr+1, 
allowing immediate entry for the next memory location. 

Changes the contents of instruction n (0 through 3 from left to 
right) at memory location addr (eight digits) to cont; cont may be 
a 15- or 30-bit instruction. However, one or more bits must be set 
in the upper 15 bits of a 30-bit instruction or the entry will be 
treated as a 15-bit instruction. The second form of the command 
performs essentially the same function but leaves the address at 
addr+1, allowing immediate entry for the next memory location. 3 

Changes the contents of extended memory location addr to cont. 
The second form of the command performs essentially the same 
function but leaves the address at addr+1, allowing immediate 
entry for the next extended memory location. 

Changes the contents of byte b at extended memory location addr 
to cont. Each location consists of five 12-bit bytes, numbered 
through 4 from left to right. The contents are four octal 
characters. The second form of the command performs essentially 
the same function but leaves the address at addr+1, allowing 
immediate entry for the next extended memory location. 

Changes the contents of extended memory location addr to 
display code characters cont (left-justified and zero-filled). The 
second form of the command performs essentially the same 
function but leaves the address at addr+1, allowing immediate 
entry for the next extended memory location. 3 



3. If the message REPEAT ENTRY is displayed above the entry line, the cont field is not cleared and may be entered in successive 
memory locations as many times as desired by pressing CR or NEXT. The repeat entry mode is enabled by pressing CR or NEXT 
before initial entry of the command. This is also applicable to the b and n fields of the second, fifth, and seventh commands. 
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PP Call Commands 

Any PP program having a name that begins with a letter may be initiated by DIS. However, 
before entering any of these commands, it is necessary to have a working knowledge of the 
PP program to be called. This ensures correct use of the specified program. 

CAUTION 

Improper use of these commands may result in damage to the system or to user jobs. 

In table 4-1, prg denotes the name of the PP program and n is the control point number. 
Table 4-1. PP Call Formats 



Format of PP 

Command Description Call Initiated 

prg. Calls PP program prg to the control point. 18/3Lprg,6/n,36/0 

prg,pl. Calls PP program prg to the control point; pi 18/3Lprg,6/n,18/0,18/pl 

is an octal parameter required by prg. 

prg,pl,p2. Calls PP program prg to the control point; pi 18/3Lprg,6/n,18/pl,18/p2 
and p2 are octal parameters required by prg. 
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Display Selection Commands 5-2 

Dayfile Commands 5-3 

Queued File Utility Commands 5-4 

Job Processing Control Commands 5-4 

General Job Control Commands 5-4 

Interactive Job Control Commands 5-8 

Job Communication Commands 5-9 

Job Flow Commands 5-10 

Peripheral Equipment Control Commands 5-24 

Subsystem Control Commands 5-50 

System Control Commands 5-56 

Secured System Control Commands 5-70 

Memory Entry Commands 5-72 

Channel Control Commands 5-74 

Extended Memory Flag Register Commands 5-75 

Breakpoint Package Commands 5-75 

PP Breakpoint Commands 5-75 

V Display 5-77 

PP Breakpoint Precautions 5-79 

CPUMTR Breakpoint Commands 5-80 

CPUMTR Breakpoint Display (C Display) 5-81 

CPUMTR Breakpoint Precautions 5-83 

Debugging Commands 5-84 
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After the system has been deadstarted successfully, you can enter the DSD commands 
necessary to provide optimum performance and reliability for users. The following general 
categories of DSD commands are available for this purpose. 



Category 



Display selection 
Dayfile 

Queued file utility 
Job processing control 

Peripheral equipment control 

Subsystem control 

System control 

Memory entry 
Channel control 

Extended memory flag register 
Breakpoint package 
Debugging commands 



Description 



Selects DSD displays. 

Dumps the system, account, or error log dayfile to 
a specified device. 

Provides control over selected queued files. 

Provides added control over job scheduling and 
processing. 

Controls the peripheral equipment available to the 
system. 

Schedules a subsystem to a control point or 
terminates a current subsystem. 

Maintains system integrity in a normal production 
environment or debugs a system that is in an 
abnormal state. 

Changes the contents of central memory and 
extended memory. 

Controls activity on a specified data channel in 
circumstances where abnormal hardware and/or 
system operation is detected. 

Clears and sets bits in the extended memory flag 
register. 

Provides control over PP breakpoint processing 
and CPUMTR breakpoint processing. 

Traps certain conditions and traces selected pool 
PP to CPUMTR and MTR to CPUMTR functions. 



Although all DSD commands are generally available, many of them are seldom used in a 
normal production environment. Many DSD commands are used only by the system analyst 
for maintenance or debugging. These commands include all memory entry and channel 
control commands as well as several commands in the other categories listed on an 
unsecured system. Memory entry and several other commands are restricted on a secured 
system (refer to the UNLOCK command later in this section). 

When unusual problems arise, do not attempt corrective action unless you have 
considerable experience relating to the current problem. Misguided attempts to correct a 
system problem can often destroy information required to successfully analyze the problem. 
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Display Selection Commands 



To assist customer engineers and software analysts in tracking problems, the system enters 
the first characters (up to 25) of the following commands into the error log after each 
execution. 

DOWN.param. 

FORM,param. 

IDLE,param. 

INITIALIZE,param. 

LOG,param. 

OFF.param. 

ON,param. 

REDEFINE,param. 

99. 

Memory entry commands 

Channel control commands 

Any other commands that you specify at installation time 

These commands are prefixed by the characters DS in the error log but otherwise appear 
exactly as they are entered. This feature can be enabled and disabled using the 99 
command (refer to System Control Commands later in this section). 

The manner in which the DSD commands are entered and the use of special keyboard 
characters are described in the NOS Version 2 Operations Handbook. Command formats are 
fixed field; that is, the fields in the command format must be specified as shown. Embedded 
blanks are allowed in octal fields. Leading spaces in command entries are not allowed. 

Display Selection Commands 

The system display program DSD generates system-oriented displays. You can select any of 
the DSD displays with the following DSD command: 

xy. 

where x and y represent the letter designation (screen identifier) of the displays. 

Display x appears on the left screen and display y appears on the right screen. If x and y are 
identical, both screens display the same information, except for the B and P displays when 
using the CC598B or CC634B console. Refer to the NOS Version 2 Operations Handbook for 
details concerning the DSD display formats and keyboard operating instructions. 

You can specify a sequence of DSD displays that you want displayed on the left screen. To 
preselect the left screen display sequence, enter the following DSD command: 

SET, screens. 

where screens represents a string of four letters (screen identifiers) designating any four 
DSD displays. Usually you specify four different displays although DSD accepts any four 
valid screen identifiers. Refer to the NOS Version 2 Operations Handbook for DSD displays 
and keyboard operating instructions. 
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Dayfile Commands 

The system saves messages in five types of dayfiles. 

• Account dayfile 

• Binary maintenance log 

• Error log 

• Job dayfile 

• System dayfile 

The account dayfile keeps a record of all resources charged to a job. This dayfile can be used 
for customer billing and other accounting purposes. The binary maintenance log records the 
information used in Control Data maintenance in binary format. The error log records 
system error messages, such as disk errors. Job dayfiles keep entries for individual jobs. 
The system dayfile keeps a history of all commands for all jobs processed. 

The following commands dump the account dayfile, system dayfile, or error log to a 
system-defined mass storage device. The resultant mass storage file is put in the output 
queue for printing. The system automatically prints the job dayfile at the end of the job's 
output. 

Command Description 



KAFD. Requests that the account dayfile be dumped to a system-defined 

mass storage device. The resultant mass storage file is put in the 
output queue for printing. 

X.DFD. Requests that the system dayfile be dumped to a system-defined 

mass storage device. The resultant mass storage file is put in the 
output queue for printing. 

X.ELD. Requests that the error log be dumped to a system-defined mass 

storage device. The resultant mass storage file is put in the 
output queue for printing. 

Refer to section 18, Queue/Dayfile Utilities, for more information on dayfile dumps. 

The binary maintenance log is designed to be processed through an interpreter program, 
and therefore is normally dumped to tape or disk. 

Refer to the NOS Version 2 Operations Handbook for descriptions of dayfile displays. 
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Queued File Utility Commands 

The following commands are used to control queued input and output files. 

C omman d Description 

X.QREC Deactivates or activates selected queued files and purges selected inactive 

queued files. 

X.QMOVE Moves queued files from one mass storage device to another. 

Refer to section 18, Queue/Dayfile Utilities, for more information on queued file utility 
commands. 

Job Processing Control Commands 

Under normal circumstances, control over job processing is performed automatically by the 
system. Although the following commands may not be used frequently, they provide an 
added measure of control over job processing. 

General Job Control Commands 

Several of the commands described here change internal system parameters which control 
job scheduling and processing. Give careful consideration to their use since job flow and 
overall system performance can be affected. Refer to the individual command descriptions 
for farther information. 

Command Description 

CKP jsn. Checkpoints the job with job sequence name jsn. The checkpoint 

information includes a copy of the job's field length, the system 
information used for job control, and the name and contents of all 
local files currently assigned to the control point. It is the 
responsibility of the user's job to establish a magnetic tape or 
mass storage permanent file to receive the checkpoint 
information. Otherwise, checkpoint information is automatically 
written to a local file named CCCCCCC and is not available if a 
restart becomes necessary (restart is user-controlled and is 
accomplished using the RESTART command). Refer to the NOS 
Version 2 Reference Set, Volume 3 for supplementary information 
concerning the checkpoint/restart feature available to users. 

NOTE 

If the current job command has secure system memory (SSM) 
status set, the job cannot be checkpointed. SSM status is set for 
certain jobs to prevent dumping of the job's field length. 
Subsystems cannot be checkpointed. 
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Command 



Description 



DROPjsn,qt,ujn. 



Drops the job with job sequence name jsn from the queue qt where 
it currently resides. If a jsn is not specified, a 1- to 7-character 
user job name ujn can be specified after the queue type. 

The console must be unlocked to use this form of the DROP 
command. If no jsn or ujn is specified, all jobs in the specified 
queue type are dropped. If the queue type is not specified, the 
default is the executing queue. 

The DROP command cannot be used to terminate a subsystem. 
Also the DROP command will not terminate an interactive user's 
session (this can be done only with a KILL command). 

The queue type is one of the following: 

qt Queue Type ___^___ 

ALL All jobs and queued files. 

EX All jobs in the executing queue (including the rolled out 
jobs). 

IN All jobs in the input queue. 

PL All jobs in the plot queue. 

PR All jobs in the print queue. 

PU All jobs in the punch queue. 

WT All jobs in the wait queue. 



ENPRjsn,pr. 

ENPRjsn,*. 

ENQPjsn,pr. 



Sets the CPU priority for the job with job sequence name jsn to pr 
(2 < pr < 67 8 ). 

Sets the CPU priority for the job with job sequence name jsn to 
the value defined for the job's service class. 

Enters queue priority of pr for a queue type file with job sequence 
name jsn. The value of pr can range from the minimum to the 
maximum for the job's service class. If the priority is zero, an 
input file is not scheduled back to a control point automatically. 
The value specified overrides the current queue priority for the 
file. The current queue priority can either be increased or 
decreased using this command. 
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Job Processing Control Commands 



C omman d 



Description 



KILLjsn. 



OVERRIDEjsn. 



Drops the job with job sequence name jsn from the executing job 
table (EJT) without exit processing. If you want the job to 
proceed with exit processing, use the DROP command. The KILL 
command cannot be used to drop a subsystem. 

KILL is the only command that immediately terminates an 
interactive user's session. The DROP and OVERRIDE commands 
only terminate the current job step and do not log the user out of 
the system. There will be no recoverable job after you issue the 
KILL command. 

NOTE 

Before initiating the command, ensure that the correct job 
sequence name has been specified. 

In some cases, a KILL command will be intercepted by a job's 
reprieve processing. If the job does not terminate after finishing 
its reprieve processing, issue another KILL command to 
terminate the job. 

Certain types of job processing are unaffected by the DROP, 
KILL, or STOP commands. These include operations such as 
setting permanent file device interlocks, interlocking files/tracks, 
clearing VSN entries, and waiting for certain types of tape/PP 
activity to end. The OVERRIDE command terminates this type of 
processing and drops the job with job sequence name jsn from the 
executing job table regardless of queue priority. The OVERRIDE 
command will not terminate an interactive user's session (this 
can be done only with a KILL command). Unlock the console 
(refer to the UNLOCK command later in this section) to enter 
this command. Use of this command is recorded in the error log. 

NOTE 

Exercise extreme caution in using the OVERRIDE command. 
Undesirable situations (such as interlocks being left set, VSN 
entries remaining uncleared, or certain tape/PP activities left 
outstanding) could occur that would cause potentially damaging 
system activity. Never use this command during normal 
operations. 
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Command 



Description 



RERUNjsn. 

ROLLINjsn,L. 

ROLLOUTjsn,sd. 



Terminates the job with job sequence name jsn, then reruns the 
job from the beginning. The job must be in rerun status as set by 
the RERUN command or macro. 

Allows the job denned by job sequence name jsn to be scheduled 
to an available control point. L is optional; if omitted, the job can 
be selected by the scheduler for rollout. 

Removes the currently executing job with job sequence name jsn 
and makes it a rolled out job. A subsystem cannot be rolled out. 
sd is the number of scheduler intervals before the job can be 
scheduled again. The acceptable range for sd is between and 
777 8 . If sd is not present or is 0, the job is not scheduled back to 
a control point automatically. That is, your action is required to 
return the job to a control point. This can be done by using the 
ROLLIN command. 

The amount of time required for one job scheduler interval is 
initially set in the IPRDECK but may be changed by using the 
DELAY command ( JS parameter) described later in this section. 
Normally, it is a 1-second interval. 
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Interactive Job Control Commands 



The following commands apply only to interactive online jobs. The interactive facility 
subsystem must be active at control point 1. Refer to the CDCNET Network Operations 
Manual for information about sending messages to terminal users that are connected 
through CDCNET. 



Command 



Description 



DIALjsn,messagetext. 
DIAL,*,messagetext. 



WARN,messagetext. 



WARN. 



Sends message messagetext (48 characters maximum) to the 
terminal currently assigned to the job with job sequence name jsn 
(when jsn=*, the message is sent to all active terminals). 
Examine the T display to determine the appropriate job sequence 
name. The message is sent to the terminal immediately except 
when output is being sent to the terminal. In that case, the 
message follows the output data. 

Sends message messagetext (48 characters maximum) to all 
terminals currently logged into IAF. The message is received at a 
terminal upon completion of the current command or at the end 
of a job step. Each subsequent terminal that logs into IAF also 
receives this message. This continues until either a new message 
is entered or the message is cleared by using the WARN 
command. In addition, the current message also appears at the 
IAF Subsystem control point on the B,0 display. 

When sent to an interactive terminal, the message messagetext is 
always preceded by the statement 



hh.mm.ss . 



WARNING 



specifying the time (hours.minutes.seconds) when you entered the 
WARN command. 

For example, if you enter 

WARN, SYSTEM SHUTDOWN AT 1500. 

the following information would be transmitted to all interactive 
terminals. 

hh . mm . ss . WARNING 
SYSTEM SHUTDOWN AT 1500. 

This command is typically used to notify interactive users of an 
interruption in service or system shutdown. 

Clears the message entered by the WARN,messagetext command. 
Unless this command is entered, the existing message (if any) 
continues to be transmitted to each new terminal that logs into 
IAF. 
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Job Communication Commands 

The following job communication commands are used to communicate with a job currently 
in the executing job table. 



Command 



Description 



CFOjsn.messagetext. 



COMMENT jsn. 
messagetext 

GOjsn. 



OFFSWjsn,s 1 ,s 2 ,...,s 6 . 



ONSWjsn^^Ss,...^. 



PAUSEjsn. 



Sends a message messagetext (36 characters maximum) from the 
console to the job with job sequence name jsn. Bit 14 of the job's 
RA must be set before the CFO command is accepted. The 
message is placed in locations RA+70 8 through RA+74 8 of the 
program's field length. 

Enters comment messagetext (48 characters maximum) in the 
dayfile for the job with job sequence name jsn. 

Clears the pause bit of the job with job sequence name jsn. A job 
may set the pause bit if an error is encountered or if an operator 
response is required. If jsn is not specified, the command applies 
to the system control point. 

Turns off one or more sense switch(es) Sj (1 < S; < 6) of the job with 
job sequence name jsn. Refer to Subsystem Control Commands 
later in this section for definitions of the sense switches that can 
be set for the BIO, IAF, MSE, and TAF Subsystems. 

Turns on sense switch(es) Sj (1 < Sj < 6) of the job with job 
sequence name jsn. Refer to Subsystem Control Commands later 
in this section for definitions of the sense switches that can be set 
for the BIO, IAF, MSE, and TAF Subsystems. 

Sets the pause bit of the job with job sequence name jsn. If jsn is 
not specified, the command applies to the system control point. 
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Job Flow Commands 

The following job flow commands affect scheduling and execution of jobs in the system. 
Improper use of these commands can drastically hamper job flow as well as system 
performance. In certain cases, jobs may be lost. 

The priority associated with each priority parameter in the following commands is 
established by an entry in the IPRDECK for each service class. The value of each priority 
parameter for each service class is listed on the system control display(s) (refer to the NOS 
Version 2 Operations Handbook for more information on the S display). 



Command 



Description 



CLASS,ot,sc 1 ,sc 2 ,...,sc n . Defines the authorized service class for each origin type. Refer to 

the SCTD L display in section 9, L-Display Utilities, for further 
information. 



Parameter Description 



ot 



SCj 



Origin type (must be batch, remote batch, or 
interactive). This parameter is order dependent. 
Types with brief descriptions follow: 

BC Batch. 

RB Remote batch. 

IA Interactive. 

Authorizes service classes for the specified origin 
type. Entering a service class that already has 
validation clears validation for that service class. 
Service classes with brief descriptions (in 
parentheses) follow: 

BC (Local batch). 

CT (Communication task). 

DI (Detached interactive). 

In [Installation class n (0 < n < 8)]. 

MA (Maintenance). 

NS (Network supervisor). 

RB (Remote batch). 

SY (System). 

TS (Interactive). 

ALL (Sets all classes except SS and DS). 

NUL (Clears all service classes). 
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Command 

CPTT=n 



Description 



DELAY.pj.Pa,...,?!!. 



Changes the CPUPFM transfer threshold (CPTT) to the value n 
(0 < n < 7777 8 PRUs). The value of CPTT determines whether an 
indirect access file transfer will be processed entirely within the 
PP program PFM or whether the CPU program CPUPFM will be 
called to perform the transfer. Since CPUPFM can transfer large 
files faster than PFM, CPUPFM will transfer files that exceed the 
threshold value. 

The default value is 100 8 sectors, as defined in common deck 
COMSPFM. Depending on the configuration, you may want to 
adjust this value up or down. A site with buffered I/O devices, for 
example, may find it advantageous to set a lower value. To 
disable CPUPFM transfers altogether, enter CPTT=0. The 
current value of CPTT is displayed on the W,M display. 

Alters current system delay parameters. Examine the W,M 
display to determine the current delay parameter values. 



Description 



ARar PP recall interval in milliseconds. This parameter 
specifies the default time interval after which a 
peripheral processor program in the PP recall queue 
will be recalled, ar ranges from 1 to 7777 8 . 

CRcr CPU recall period in milliseconds. This parameter 

specifies the amount of time a job remains in recall (X 
status) when an RCL request is placed in RA+1. cr 
ranges from 1 to 7777 8 . 

JQjq Exponent used to determine the input file scheduling 

interval in seconds, jq ranges from to 14 8 . The 
interval in seconds between scheduling of input files is 
calculated as follows: 

interval = 2**jq 

JSjs Job scheduler interval in seconds. This parameter 

specifies the interval in which the job scheduler is 
called. The scheduler may also be called at other 
times, js ranges from 1 to 7777 8 . 
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Command 



Description 



DELAY,p 1 ,p2,.-.,p n - (Continued) 



Ei_ 



Description 



MPmp Memory padding value expressed as 100 8 word 

blocks, mp ranges from to 777 8 . This parameter 
specifies how much additional (unassigned) 
memory should be allocated between the end of the 
newly assigned job field length and the beginning 
of the next job. Increasing this value reduces the 
probability that a job will be storage moved in 
response to a request for more memory. 

The value for each system delay parameter may be established by 
using a DELAY command entry in the IPRDECK If no DELAY 
entry is present, default values are provided. Figure 5-1 provides 
space to record the original values (specified in the W,M display) 
in the event that any are altered temporarily. For additional 
information concerning the DELAY command, refer to section 3, 
Deadstart Decks. 




Figure 5-1. Record of Original Values in W,M Display (Delay Values) 
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Command 



Description 



PCLASS,sc ,sc 1 ,. .. ,sc 7 . 



Selects the service class associated with each priority level 
(p through P 7 ) on the Job command. This parameter is order 
dependent; a comma must appear for any parameters not 
specified. The default for any parameters not specified is (zero). 
Subsystem (SS) service class is not allowed with this command. 
Refer to the SCTD L display in section 9, L-Display Utilities, for 
more information. 

scj is a 2-eharacter service class parameter. Entries are listed and 
briefly described below. 



sc s 


Description 


BC 


Local batch. 


CT 


Communication task. 


DI 


Detached interactive. 


In 


Installation class n (0 < n < 8). 


MA 


Maintenance. 


NS 


Network supervisor. 


RB 


Remote batch. 


SY 


System. 


TS 


Interactive. 
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Command 



Description 



QUEU£,8c,qt^p lt 

qp2»-,qp n - 



Alters the queue priorities qpj associated with the input, 
executing, and output queues qt for each service class sc. 
Examine the L display SDSPLAY to determine the priority values 
currently associated with each service class. 



sc 


Description 


BC 


Local batch. 


CT 


Communication task. 


DI 


Detached interactive. 


In 


Installation class n (0 < n < 8). 


MA 


Maintenance. 


NS 


Network supervisor. 


RB 


Remote batch. 


SS 


Subsystem. 


SY 


System. 


TS 


Interactive. 



There are three job queue types. 
qt Description 



EX 


Executing. 


IN 


Input. 


OT 


Output. 
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Command Description 



QUEUE.sc.qt.qp!, (Continued) 

qp 2 „...,qp n . 



There are five priorities. 
qPj Description 



ILil Priority a job receives when it initially exhausts its 

CM time slice (refer to the SERVICE command CM 
parameter). Thereafter, whenever the CM time slice 
is exhausted, the job's priority will be set to the 
value of lp. il ranges from to 7777 8 , but must be in 
the range of values for lp and up. This parameter is 
valid only for executing jobs (EX). 

IPip Initial scheduling priority for an executing batch job 

or for an interactive job when a terminal command is 
entered. Online interactive jobs with terminal I/O 
available are scheduled at tp priority (refer to the 
SERVICE command TP parameter), ip ranges from 
to 7777 8 , but must be in the range of values for lp 
and up. 

LPlp Lowest priority. For an input or output queue file, 

the priority assigned to a file or job entering the 
designated queue. For an executing job, the priority 
assigned to a job which has exceeded a non-initial 
CM slice. The IL value is used for the first CM slice. 
lp ranges from to 7777g, but must be less than the 
value of up. 

UPup Highest priority. For input and output queues, this 

is the highest priority a file can reach in that queue; 
aging stops when this priority is reached. For the 
execution queue, this is the priority assigned to a job 
when initially assigned to a control point, up ranges 
from to 7777 8 , but must be greater than the value 
oflp. 

WFwf Weighting factor wf for queue priority calculation, wf 

must be a power of 2, from 1 to 4000 8 . The smaller 
the weighting factor, the faster the queue entry 
reaches its highest priority. 

The priority associated with each queue is established by using 
QUEUE command entries in the IPRDECK for each service class. 
These entries normally reflect the ideal queue priorities for the 
job mi-x of the particular installation. The values specified in the 
IPRDECK are considered critical to optimum system performance 
and are not normally altered. Figure 5-2 provides space to record 
the original values specified in the L display SDSPLAY. For 
additional information on the QUEUE command, refer to section 
3, Deadstart Decks. 
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Figure 5-2. Record of Original Values in L Display SDSPLAY 
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Command 



Description 



SERVICE,sc,p 1 ,P2,-,Pn- Alters the service limits p; associated with each service class sc. 



sc 



Ei_ 



Description 



BC Local batch. 

CT Communication task. 

DI Detached interactive. 

In Installation class n (0 < n < 8). 

MA Maintenance. 

NS Network supervisor. 

RB Remote batch. 

SS Subsystem. 

SY System. 

TS Interactive. 



Description 



AMam Maximum field length/100 8 for all jobs of the 

specified service class. This parameter is used to 
partition central memory by limiting the total field 
length available to each service class. For example, 
if scheduling a job to a control point would cause the 
AM value to be exceeded for its service class, it may 
not be scheduled until the required field length is 
available. This means that a lower priority job from 
a different service class may be scheduled first. 
However, a job that would cause the AM value for 
its service class to be exceeded can be scheduled to a 
control point if there are not enough jobs in other 
service classes to fill the central memory and if 
FLEXIBLE PARTITIONS is enabled. The system 
always attempts to use central memory to its 
greatest capacity, am ranges from to 77777 8 . 

CMcm Central memory time slice in seconds. This 

parameter specifies the maximum amount of time a 
job of the specified service class can remain in 
central memory, either at a control point or at a 
pseudo-control point, before its priority is set to the 
lower boundary. When the job initially exhausts its 
CM time slice, this lower boundary is the value of il. 
Subsequently, when the job exhausts its CM time 
slice, this lower boundary is the value of lp (refer to 
the QUEUE command IL and LP parameters), cm 
ranges from to 7777 8 . 
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Command Description 



SERVICE,sc,p 1 ,P2,...,p I1 . (Continued) 

2j Description 



CPcp Control point slice priority. This parameter specifies 

the value of the scheduling priority which will be set 
after a job has been at a control point for ct seconds. 
The priority specified must be greater than or equal 
to the lower bound and less than or equal to the 
upper bound execution queue scheduling priorities 
specified by the CB parameter (lp < cp < up). Refer 
to the QUEUE command LP and UP parameters. 

CScs Cumulative size in PRUs allowed for all indirect 

access permanent files; cs indicates a limit value for 
the cumulative size: 

Unlimited 

1 1000 8 

2 5000 8 

3 50000 8 

4 100000 8 

5 200000 8 

6 400000 8 

7 Unlimited 

CTct Control point time slice in seconds. This parameter 

specifies the maximum amount of time that a job of 
the specified priority can remain at a control point 
before its priority is changed to the control point 
slice priority (cp). ct ranges from 1 to 7777 8 . 
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Command Description 



SEKVICE,sc,p 1 ,P2,— ,P n - (Continued) 

£j Description 



DSds Size in PRUs allowed for individual direct access 

permanent files; ds (0 through 7) is used to specify 
the corresponding values shown next: 

Unlimited 

1 1000 8 

2 5000 8 

3 50000 8 

4 100000 8 

5 200000 8 

6 400000 8 

7 Unlimited 

DTsc Service class to which a detached job is assigned. 

The default value for sc is DI (detached interactive). 

ECec Maximum user-accessible extended memory field 

length in words divided by UEBS 1 for any job of the 
specified service class. This parameter performs the 
same function for extended memory field length 
that the FL parameter does for central memory 
field length, ec ranges from to 3777 8 . 

EMem Maximum extended memory divided by UEBS 1 for 

all jobs of the specified service class. This parameter 
performs the same function for extended memory 
field length that the AM parameter does for central 
memory field length, em ranges from to 3777 8 . 



1. Refer to Extended Memory Overview in section 3 to determine the value of UEBS. 
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Command Description 



SERVICE,sc,p 1 ,P2,-..,p I i. (Continued) 

Pj Description 



FCfc Number of permanent files allowed; fc (0 through 7) 

is used to specify the corresponding values (limit 
value in octal) shown next: 



Unlimited 



110 8 



2 40 8 

3 100 8 

4 200 8 

5 lOOOg 

6 4000 8 

7 Unlimited 

FLfl Maximum field length divided by 100 8 for any job of 

the specified service class. If more memory is 
requested, the job is aborted. You typically use this 
parameter to limit the memory requirement for jobs 
of a specific service class during certain hours of the 
day. For example, you may use the FL parameter 
to specify a maximum field length for all batch 
service class jobs between the hours of 2 p.m. and 4 
p.m. fl ranges from to 7777 8 . 

FSfs Size in PRUs allowed for individual indirect access 

permanent files; fs (0 through 7) is used to specify 
the corresponding values (limit value in octal) 
shown next: 

Unlimited 

110 8 

2 30 8 

3 100 8 

4 300 8 

5 1000 8 

6 2000 8 

7 Unlimited 
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Command 



Description 



SERVICE,sc,p 1 ,P2,-,Pn- (Continued) 



Bi. 



Description 



NJnj Maximum number of jobs. For each service class, 

this parameter specifies the number of jobs that can 
be executing in the system, nj ranges from to 

7777 8 . 

PRpr CPU priority. When more than one job is waiting 

for the CPU, jobs with the highest CPU priority 
access the CPU first. Jobs with lower CPU priority 
access the CPU only when higher-priority jobs no 
longer wish to use the CPU. pr ranges from 2 to 77 8 . 

RSrs Recall CPU slice in milliseconds. The minimum 

guaranteed amount of time that a recalled job keeps 
the CPU before it can be preempted by another 
recalled job at the same CPU priority, rs ranges 
from 1 to 7777 8 , but the specified value must be less 
than or equal to the value of the unextended CPU 
slice, us. 

SEse CPU slice extension in milliseconds. The maximum 

additional amount of CPU time that a job 
performing I/O gets after its unextended CPU slice 
expires before the CPU slice expires (and the CPU 
is switched to an equal-priority job). This is the 
maximum extension. The slice is actually extended 
by the value of the recall CPU slice, rs, each time 
the job is recalled, se ranges from to 7777 8 . 

TDtd Suspension time-out delay. A suspended job will 

not be timed out for td*10 8 seconds, td ranges from 
to 7777 8 . The maximum delay is approximately 9 
hours. 

TPtp Terminal job priority assigned to a terminal job that 

is rolled out waiting for terminal input, tp ranges 
from to 7777 8 , but must be in the range of values 
for the execution queue parameters lp and up (refer 
to the QUEUE command LP and UP parameters). 

USus Unextended CPU slice in milliseconds. The amount 

of CPU time that a CPU-bound job gets before the 
CPU is switched to an equal-priority job. us ranges 
from 1 to 7777 8 , but the specified value must be 
greater than or equal to the value specified for the 
recall CPU slice, rs. 
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Command Description 

SEEVICE,sc,p 1 ,P2,—,p n . (Continued) 

The service limits associated with each service class are 
established by using SERVICE command entries in the 
IPRDECK These entries normally reflect the ideal service limits 
for the job mix of the particular installation. The values 
specified in the IPRDECK are important to optimum system 
performance and are not normally altered. However, when 
changes are necessary they are usually temporary and 
the original values will be reset. Figure 5-3 provides space to 
record the original values specified in the L display SDSPLAY. 
For additional information concerning the SERVICE command, 
refer to section 3, Deadstart Decks. 

SRST=t. Changes the secondary rollout sector threshold to the value t(0 < 

t < 7777 8 ). Any rollout file smaller than t sectors is considered a 
secondary rollout file for the purpose of equipment selection. 

NOTE 

The size of the rollout file for any job must be at least seven 
sectors larger than the combined size in sectors of the job's 
central memory and extended memory field lengths. 
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Peripheral Equipment Control Commands 

The commands described in this category provide control of the channel-connected 
peripheral equipment available to the system. 2 To control unit record equipment that is 
connected through communications ports, use the RBF K display described in section 8 and 
the PSU K display described in the NOS Version 2 Operations Handbook. You should 
become familiar with the following DSD displays, which are closely associated with the use 
of these and other commands described throughout this section. 

Equipment status display (E,A). 

Disk configuration display (E,C). 

Disk errors display (E,E). 

Family status display (E,F). 

Disk thresholds display (E,H). 

Disk status display (E,M). 

Resource requests display (E,P). 

Tape status display (E,T). 

BIO status display (I). 

A complete description of each of these displays is given in the NOS Version 2 Operations 
Handbook. 



Command 



Description 



ASSIGNjsn,est. 



Assigns equipment defined by EST ordinal est (normally a tape 
unit) to the job with job sequence name jsn. This command is 
entered in response to a flashing REQUEST message. Use of this 
command for assignment of a tape unit should not normally be 
required because tape assignment is performed automatically 
when a volume serial number (VSN) is specified in the job 
request. However, if a VSN is not specified in the job request for 
a labeled or unlabeled tape, the REQUEST message appears at 
the job's control point (on the B,0 display), and the ASSIGN 
command must be entered to assign a tape unit to the job. 

NOTE 

The mnemonic DS (assigns the console EST entry) or NE (assigns 
the null equipment EST entry) can be used instead of the EST 
ordinal for these equipments. 



BKSP,est,rr. 



Backspaces rr octal logical records on the print file for the BIO 
equipment defined by EST ordinal est. When rr is not specified, 
the default is one record. 



2. Operation of peripheral equipment is described in the NOS Version 2 Operations Handbook. 
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Command 

BKSPF,est,ff. 

BKSPRU,est,ss. 

CONTINUE,est. 

DOWN,CH=ch, 

EQ=est. 

or 

DOWN,CCH=cch, 

EQ=est. 

or 

DOWN,MCH=ch, 

EQ=est. 

or 

DOWN,EQ=est. 



Description 



Backspaces ff octal files on the print file for the BIO equipment 
defined by EST ordinal est. When ff is not specified, the default is 
one file. 

Backspaces ss physical record units (PRUs) on the print file for 
the BIO equipment defined by EST ordinal est. The PRU count, 
ss, must be specified. There is no default setting. Printing 
resumes at the beginning of a line. 

Resumes printing on the BIO equipment defined by EST ordinal 
est. 

The first two forms of the command disallow the use of channel ch 
or concurrent channel cch for the mass storage or device specified 
by EST ordinal est. If the EQ=est DOWN,CCH=cch,parameter is 
omitted, channel ch or cch is disallowed for all devices in the EST. 
The EQ=est parameter cannot be orspecified if the CH=ch or 
CCH=cch parameter specifies a magnetic tape channel. Use of all 
ports of a concurrent channel is disallowed. 

If channel ch or cch is the only channel available to a mass 
storage device, its use is disallowed providing the device is down. 
If channel ch or cch is 

• not defined as a magnetic tape or mass storage channel 

• the last active channel on an equipment that is not globally 
unloaded (status N on the E,M display) 

• a nonimpact printer channel and any equipment on the 
channel is logically ON or assigned to a control point 

the command is ignored and the following message appears on 
the left screen. 

INCORRECT ENTRY 

Correct the entry and retry the command. 

The third form of the command disallows the use of MUX channel 
ch for the equipment specified by EST ordinal est (this form 
applies only to model 176). If the EQ=est parameter is omitted, 
MUX channel ch is disallowed for all equipments in the EST. 

The fourth form of the command disallows the use of equipment 
with EST ordinal est for all channels. It disallows all access to 
the equipment by the operating system and user jobs. This device 
state is used to allow diagnostic routines exclusive use of the 
device for problem isolation and for preventing access to a device 
that is being repaired. 
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Command 



Description 



DOWN,CH=ch, 
EQ=est. 



DOWN,MID=mid. 



(Continued) 

This command also clears the SUSPCT state for a tape unit that 
is currently unavailable (but not OFF or DOWN) because an 
unrecovered hardware or tape I/O error has occurred on the tape 
or unit. This command can be entered followed by the ON,EQ=est 
command to restore the unit to service after a customer engineer 
has checked it out, or the unit has been tested following Control 
Data's recommended procedures: 

You receive an error message if you attempt to DOWN equipment: 

• That already has a DOWN status. 

• That is assigned to a job. 

• That is the last system device not DOWN. 3 

• That contains the system dayfile, account file error log, or 
maintenance log. 3 

In these cases, the following message appears. 

INCORRECT ENTRY 

Correct the entry and retry the command. 

NOTE 

This command should be used with caution since it directly 
affects the operation of system peripheral equipment. 

Confirms that a machine running in low-speed port 
multimainframe mode with machine identifier mid is down. 
Enter this command in response to a request at the system 
control point of the form: 

IF mid DOWN ENTER *DOWN,MID=mid* 

Make this entry if the machine is down; otherwise, clear the 
message by entering: 

GO, SYS. 



3. Applies only to mass storage equipment. 
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END,est,rc. 



FORM,est,fc. 



ID,est,id. 



Terminates the current operation on the BIO equipment defined 
by EST ordinal est. If est demies a line printer or card punch, 
BIO then assigns the next available file to that equipment. If est 
defines a card reader that is actively reading cards when END,est 
is entered, the job terminates at the last card read. The next card 
is treated as the beginning of a new job. If another card deck 
follows the end-of-information card (multipunch 6/7/8/9), it is 
processed normally. 

If est defines a card reader that is stopped because of a compare 
error when END,est. is entered, perform the following steps: 

1. Remove the remainder of the card deck, except the 
end-of-information card, from the card reader input hopper. 

2. Ready the card reader to read the end-of-information card. 

The job terminates; and if another card deck follows the 
end-of-information card, it is processed normally. 

The re parameter cancels a portion of the repeat count specified 
for that equipment (refer to the REPEAT command later in this 
section). For example, if the current operation on equipment est 
had been set to be repeated five times (operation performed six 
times), entering a value of 4 for re would permit the operation to 
be performed just two times. If the repeat count is zero, this 
command performs the END operation once. 

Assigns a 2-character forms code fc to the BIO line printer or card 
punch defined by EST ordinal est. Only those files in the output 
queue assigned the forms code fc are directed to equipment est. A 
user can assign a forms code to an output file using the ROUTE 
command. (For a description of the ROUTE command, refer to 
the NOS Version 2 Reference Set, Volume 3.) The value of the 
forms code can range from AA to 99. If the forms code is not 
present, the current forms code field is cleared (value is null). 

Assigns a numeric identifier id to the card punch, card reader, or 
printer defined by EST ordinal est. The value of the identifier can 
range from 00 to 67 8 . Only those files in the proper queue with 
an identifier equal to id are directed to the card punch or printer 
defined by est. Refer to the LOAD command in this section to 
assign an identifier to a queue type file. All subsequent jobs 
loaded from card reader est are assigned the identifier id. 
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Description 



IDLE,EQ=est. 



Use this command when you want to continue using the disk 
storage device specified by EST ordinal est even though it is 
failing occasionally. When the IDLE command is used in 
conjunction with the THRESHOLD command, it allows some 
degree of flexibility in deciding when to repair such a device. New 
files will not be assigned to a device with IDLE status unless no 
suitable alternative device exists, but files already on the device 
may continue to be accessed as if the device had a status of ON. If 
the device is a spun down 834, 836, 887, or 9853 drive, it will be 
automatically spun up. It may take up to 3 minutes to spin up 
the device. 

Suppose a failing disk storage device causes the system to set the 
device's status to OFF. Suppose also that the device is failing 
infrequently, for example, once or twice per hour, and contains 
several permanent files that must remain available during peak 
production periods. In this situation, you may use the 
THRESHOLD command to increase the verification failure 
threshold and then use the IDLE command to allow continued 
use of the device. This device could then be repaired after the 
peak production period has passed, causing less disturbance to 
system users. 



NOTE 



The decision to continue using a failing device should be made 
under the advisement of a customer engineer. If there is a good 
chance of data corruption due to the nature of the failure, it may 
be best to leave the device OFF until it can be repaired. 



If you enter an IDLE command for a device with a status of OFF 
or DOWN, the system performs a device verification to ensure the 
hardware is usable and the disk pack contains valid data. If this 
verification fails and the verification failure threshold is exceeded, 
the device state remains unchanged. However, if the device 
verification finds no errors the device's state changes to IDLE, the 
verification failure count (displayed on the E,H display) is set to 
zero, and any jobs that were rolled out waiting for the device are 
allowed to continue processing. 
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IDLE,EQ=est. 



IDLEFAMILY,est. 



(Continued) 

If you attempt to change a device's state to IDLE, the message 
INCORRECT ENTRY appears if one of the following conditions is 
true: 

• The device is already IDLE. 

• The device is DOWN and assigned to a job. 

• The device is DOWN and no channels are UP for the device. 

If you enter IDLE for a device with a status of ON, the 
verification process is not performed; the device state is simply 
changed to IDLE. 

If you enter IDLE for a device other than a disk, the IDLE 
command is ignored. 

This command performs one of the two following functions, 
depending on the status of the family. 

• If the family is active, the IDLEFAMILY command 
deactivates it by aborting all new jobs and USER commands 
for the family on the equipment specified by EST ordinal est. 
Jobs in progress are allowed to complete. ISF and permanent 
file utilities, such as PFDUMP, can be used on the inactive 
family. 

• If the family is inactive, the IDLEFAMILY command 
activates it. Jobs can then access the family on the 
equipment specified by EST ordinal est. 

The FAMC column of the E,F display shows the number of jobs in 
progress on the equipment. 
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Description 



INITIALIZE,op,est x , 
est2,...,est 5 . 



Reverses current setting of initialize option op for mass storage 
devices defined by EST ordinals est (maximum of five devices). 
Examine the E,A display to determine correct EST ordinals. 

op Level of Initialization ___^_ 

AF Initialize inactive account dayfile. 

AL Total initialization. 

DF Initialize inactive system dayfile. 

EF Initialize inactive error log. 

FP Format pending. 4 

FT Total initialization as full-track device. 5 

HT Total initialization as half-track device. 5 

MF Initialize binary maintenance log. 

PF Initialize permanent files. 

QF Initialize inactive queue files. 

This command provides the capability to initialize and flaw tracks 
on any mass storage device during normal system operation. 
Each time this command is entered it is logged in the error log. 

If local unload (L) status is set for the device, the INITIALIZE 
command is ignored and the following message appears on the 
left console screen. 

INCORRECT ENTRY 

However, the INITIALIZE command is allowed to execute while 
local unload status is set if an error code (CE, IL, LE) is set. 



4. Sets format pending bit in the MST for 881/883 pack reformatting. Refer to the description of the FORMAT program in 
appendix G. 

5. Device must be removable. 
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ENITIALIZE,op,est 1 , 
est2,—,est 5 . 



(Continued) 

Entry of this command does not in itself initialize the specified 
device. It merely sets initialize status for the device so that it 
may be initialized. However, if fast attach files (special system 
files) are active on the specified device and initialization level of 
AL or PF is specified, initialize status cannot be set until these 
files are returned. In this case, the message 

FAST ATTACH FILES ON DEVICE. 

appears at the system control point on the system status display 
(B,0). Refer to the description of this message in the NOS Version 
2 Operations Handbook for additional information. 

The procedure involved in initializing a mass storage device is 
described in section 8, K-Display Utilities, under the heading 
Initialize K Display. The following describes system activity when 
initialization occurs. 

If the device is shared in a multimainframe environment, 
initialization does not proceed until all other mainframes sharing 
the device have processed an UNLOAD command for the device 
and user counts on all machines are zero. If all machines have 
not unloaded the device, this control point message is displayed: 

EQest BUSY ON ID=id. 

Variable Description 

est EST ordinal. 

id Machine identifier of the first machine found without 

unload status set. 
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INITIALIZE.op^sti, 
est2,...,est 5 . 



LOAD,est,id. 



(Continued) 

If initialize status is set on this device for another mainframe, the 
INITIALIZE command is ignored and this message appears at the 
system control point on the system status display (B,0): 

INITIALIZE PENDING ON THIS DEVICE. 

When the AL initialization option is specified, the label on the 
device to be initialized is either updated or a new label is created. 
If the label on the device is bad or cannot be recognized, the new 
label is created and all current data on the device is lost. If the 
label is found to be good, it is updated and all permanent file 
information is cleared. In this case, system library or temporary 
files (local, rollout, and so forth) residing on the device are not 
disturbed. If the device being initialized is a master device, the 
system scans all other mass storage devices in the family that 
contain direct access files and releases the space for files with 
catalogs on this device. If the device being initialized contains 
direct access files, the system scans all other master devices and 
sets the catalog entries on those devices to indicate that the files 
were purged. All or part of the permanent file system can be 
initialized and then reloaded if necessary (refer to the description 
of permanent file utilities in section 17, Permanent File Utilities. 

Requests that a job be loaded from equipment defined by EST 
ordinal est (normally tape unit). The job is assigned a numeric 
identifier id ranging from 00 to 67 8 . If id is not specified, it 
defaults to 00. Examine the E,A display to determine the EST 
ordinal of the equipment to be used. 
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MOUNT,est,P. 



MOUNT,est,vsn. 



Clears the local unload (L) and global unload (N) status for a 
mass storage device and reactivates the device. If the device is a 
spun down 834 or 836 drive, it will be automatically spun up. The 
device is denned by EST ordinal est (examine the E,A display to 
determine the EST ordinal). 

When you specify P in the MOUNT command for an independent 
shared device in a multimainframe environment, the system 
presets the device with EST ordinal est. The preset (P) option can 
be specified only on the first mainframe to access the device. 

If the device defined by EST ordinal is not a mass storage device, 
the MOUNT command is ignored and this message appears on 
the left console screen: 

INCORRECT EQUIPMENT. 

If the device is shared in a multimainframe environment and 
another mainframe has an unsatisfied initialize request pending 
for that device, the MOUNT command is ignored and this 
message appears at the system control point on the system status 
display (B,0): 

INITIALIZE PENDING ON THIS DEVICE. 

Allows an operator to mount a cartridge on the Automated 
Cartridge Subsystem (ACS). The tape drive is defined by EST 
ordinal est (examine the E,A display to determine the EST 
ordinal). The cartridge is defined by its external VSN. If a 
cartridge mounted using the MOUNT command has not been 
assigned to a job for an installation-defined period of time, the 
subsystem unloads and dismounts the cartridge. 
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MSALjtsest;!, 
est2,—,est n . 



Assigns job files of type t to mass storage devices defined by EST 
ordinals estj. The specified mass storage device must be 
nonremovable. A limit of 47 devices may be specified on a single 
entry. Examine the disk status display (E,M) to determine if the 
device is nonremovable. 



t 


Description 


B 


LGO. 


D 


Job dayfile. 


I 


Input. 


L 


Local. 





Output. 


P 


Primary. 


R 


Rollout. 


S 


Secondary rollout. 


T 


Temporary. 



If no devices are specified for a file type, the system selects a 
temporary device. 

Secondary rollout files do not exist until the command SRST=t 
(where t is the size in sectors of the file, from to 7777 8 ) defines a 
threshold; the default value of a threshold is 0. All rollout files 
smaller than the threshold are secondary rollout files. These files 
are assigned to the devices specified with the MSAL,S command. 

All files greater than or equal to the threshold are assigned to the 
rollout file devices (MSAL,R command). 

The following example illustrates a use for secondary rollout files. 
Equipment 5 is extended memory via DDP. Secondary rollout 
files to extended memory is assigned by 

MSAL,S=5. 
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MSAL,t=estx, 
est 2 ,...,est n . 



(Continued) 

The threshold count is set by the SRST command so that rolled 
out files under 20 sectors long are assigned to extended memory. 
For additional information concerning the SRST command, refer 
to section 3, Deadstart Decks. 

EQPDECK 

EQ005=DP, ST=ON, SZ=4000, CH=30 . 

MSAL,S=5. 

IPRDECK 

SRST=20. 



NEXTVSN,est,vsn. 



Specifies that the tape with VSN vsn is to follow the tape 
currently mounted on the magnetic tape unit defined by EST 
ordinal est. This command is allowed only in response to the 
following prompt on the E,P display: 

NEXTVSN , EST , VSN TO CONTINUE 

This message is posted when an end-of-reel condition occurs on a 
tape file and the user does not specify the VSN of the next reel. 
The EST ordinal of the affected tape unit is displayed under the 
UNIT header on the E,P display. After entry of the NEXTVSN 
command, a request to mount the specified VSN is posted on the 
E,P display. 
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OFF,EQ=est. Logically turns off the device defined by EST ordinal est. This 

command allows you to logically remove a device from the 
operating environment so that no user access of the device is 
permitted. If a user job attempts to access the device, it is rolled 
out to wait for the device status to become ON or IDLE. However, 
system utilities are permitted to access the device, so it can be 
dumped or loaded. If the device is a spun down 834, 836, 887, or 
9853 drive, it will be automatically spun up. It may take up to 3 
minutes to spin up the device. 

If you enter the OFF command for a device with a status of 
DOWN, the system performs a verification of the device label. 
This provides assurance that the correct pack is mounted on the 
drive and the controller is accessing the right drive after a repair 
action. 

If you attempt to change a device's state to OFF, the message 
INCORRECT ENTRY appears if one of the following conditions is 
true: 

• The device is already OFF. 

• The device is DOWN and assigned to a job. 

• The device is DOWN and no channels are UP for the device. 

Examine the E,A display to determine the EST ordinal and 
current status (ON, OFF, IDLE, or DOWN) of the device. If est 
specifies a disk storage device and the system library or 
temporary files (local, rollout, and so forth) reside on that device, 
it should not be turned off. Examine the disk status display (E,M) 
to determine which disk storage devices have system residency or 
allow system allocation of temporary files. In addition, if an MSAL 
entry is currently specified for a disk storage device, it is cleared 
when that device is turned off. The MSAL designation is not reset 
automatically when the device is turned back on and must be 
reset manually (if necessary) using the DSD command MSAL. 

This command also clears the SUSPCT state for a tape unit that 
is currently unavailable (but not OFF or DOWN) because an 
unrecovered hardware or tape I/O error has occurred on the tape 
or unit. This command can be entered followed by the ON,EQ=est 
command to restore the unit to service after a customer engineer 
has checked it out, or the unit has been tested following Control 
Data's recommended procedures. 
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ON,EQ=est. 



PRSIZE,est,ps. 
REPEATjsn,rc. 6 



Logically turns on the device defined by EST ordinal est. This 
command allows you to activate a device currently having OFF 
status in the EST. If the device is a spun down 834, 836, 887, or 
9853 drive, it will be automatically spun up. Examine the E,A 
display to determine the EST ordinal and current status (ON, 
OFF, IDLE, or DOWN) of the device. 

Use this command to bring a disk storage device back into use 
following its repair. You can also use the ON command after 
repairing a controller that provides the only access to a disk 
storage device. 

When you enter ON for a device with a status of OFF or DOWN, 
the device's state does not change to ON immediately. First the 
system attempts to verify that the drive and channels accessing 
the device are usable and the data on the disk pack is in the 
proper format. If this verification process fails and the verification 
failure threshold is exceeded, the system sets the device's state to 
OFF. If the verification finds no errors, the device's state changes 
to ON, the verification failure count (displayed on the E,H 
display) is set to zero, and any jobs that were rolled out waiting 
for the device are allowed to continue processing. 

If you enter ON for device with a status of IDLE, the verification 
process is not performed; the device's state simply changes to ON. 

If you attempt to change a device's state to ON, the message 
INCORRECT ENTRY appears if one of the following conditions is 
true: 

• The device is already ON. 

• The device is DOWN and assigned to a job. 

• The device is DOWN and no channels are UP for the device. 

Sets the paper status ps to short (S) or long (L) paper for the 
printer with EST ordinal est. Short paper has a form length of 
8.5 inches and long paper has a form length of 11 inches. 

Alters the repeat count for the queue file specified by job sequence 
name jsn. If the file is still in the queue, the repeat count for the 
file is set to re. If the file is already being processed by BIO, the 
remaining repeat count for the file is increased by re. The 
maximum value that can be entered for re is 77 8 . The default 
value for re is 1. 



6. When the current BIO operation is repeated, maximum line and card limits are reinitialized prior to printing or punching of the 
file being processed. User control limits apply individually to each output file copy produced. 
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REPRINT,est,pr. 



REPUNCH,est,pr. 



RESTORE,est. 



RETRYest. 



Terminates the current operation on the BIO printer equipment 
denned by EST ordinal est and reenters the job in the print queue 
with a queue priority specified by prOO (service class mini m u m < 
prOO < service class maximum; refer to the S display in the NOS 
Version 2 Operations Handbook; pr value is multiplied by 100 8 
internally). If pr is not specified, the service class default priority 
is assigned. 

Terminates the current operation on the BIO card punch 
equipment defined by EST ordinal est and reenters the job in the 
punch queue with a queue priority specified by prOO (service class 
minimum < prOO < service class maximum; refer to the S display 
in the NOS Version 2 Operations Handbook; pr value is 
multiplied by 100 8 internally). If pr is not specified, the service 
class default priority is assigned. 

Initiates the restoration of parity protection for the 583x (DAS) 
device defined by EST ordinal est. This command is valid only for 
a device with a device type of ED, EF, or EH. 

Reissues a tape operation that previously aborted with one of the 
following load point errors appearing in the E,P display: 

CLEANER FAULT 
READ ID BURST 
WRITE ID BURST 

est represents the EST ordinal of the tape unit where the load 
point error occurred. Examine the E,P display to determine the 
EST ordinal. The tape unit must be ready before you enter the 
RETRY command. Examine the E,T display to ensure that the 
tape is loaded and the tape unit is ready. 

The RETRY command is to be used after the system detects a 
load point error on a tape. Upon detecting such an error, the 
system issues an error message to the E,P display and unloads 
the tape. The operator then has the opportunity to fix the failing 
tape or tape drive. Upon completing this step, the operator 
reloads the tape on the same tape unit and enters the RETRY 
command. The system then reissues the tape operation. If the 
failure cannot be fixed at this time, the operator should enter the 
TERMINATE command to abort the recovery attempt. 
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SCEATCH,est. 



SECUREQ.est, 
LA=lowerlevel, 
UA=upperlevel. 



SK3P,est,rr. 
SKIPF,est,ff. 



Declares the tape mounted on an unassigned magnetic tape unit, 
denned by EST ordinal est, to be a scratch tape. This command 
enables a tape to be available to satisfy scratch VSN requests and 
still be assigned by its original VSN. Thus, the VSN denned on 
the tape (in VOL1 label) is not redefined as scratch although the 
VSN will appear as SCRATCH on the tape status display (E,T). 

Scratch status is retained for only one job assignment. This allows 
a tape to be used for scratch purposes on a temporary basis. For 
example, a job requests a tape mounted on the tape unit denned 
in this command by specifying the current VSN for that tape in 
the request. The tape is then assigned to the job as a scratch tape 
(the original VSN is retained and not made scratch). When that 
job releases the tape, SCRATCH status is cleared, and unless this 
command is entered again, that tape would not be assigned as a 
scratch tape in future requests. To determine if SCRATCH status 
is in effect for a tape, monitor the tape status display (E,T). 

Changes the equipment access level limits for the unit record 
equipment with EST ordinal est. On a secured system, only files 
that have access levels within these limits can be printed on the 
specified equipment. The original limits are set during deadstart 
by the ACCESS command entries in the EQPDECK. The 
parameters LA=lowerlevel and UA=upperlevel specify the lower 
and upper access level limits for the equipment. 

NOTE 

On a secured system this command is accepted only if a security 
administrator has placed the system in security unlock status. 

Skips forward rr octal logical records on the print file for the BIO 
equipment defined by EST ordinal est. When rr is not specified 
the default is one record. 

Skips forward ff octal files on the print file for the BIO equipment 
defined by EST ordinal est. When ff is not specified the default is 
one file. 
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SKIPRU,est,ss. 



SPINDOWN,est. 
SPINUP,est. 



Skips forward ss PRUs on the print file for the BIO equipment 
defined by EST ordinal est. All parameters must be specified; 
there are no default settings. The PRU count, ss, is limited to 10 8 
PRUs (the current buffer size) plus the number of PRUs 
remaining in the buffer. If the buffer was empty, ss would be 
limited to 20 8 PRUs. If ss is larger than the number of PRUs 
remaining in the buffer, the buffer is filled again and the 
additional PRUs are skipped on the new print file. For example, 
if five PRUs remained in the print file and ss was specified as 10, 
the remaining five PRUs would be skipped, the buffer filled again, 
and five additional PRUs skipped. Printing resumes at the 
beginning of a line. 

Spins down the 834, 836, 887, or 9853 disk storage device defined 
by EST ordinal est. To enter this command, the console must be 
unlocked (refer to the UNLOCK command later in this section). 

Spins up the 834, 836, 887, or 9853 disk storage device defined by 
EST ordinal est. 



STOP.est. 



NOTE 



Spinning down an 834, 836, 887, or 9853 disk storage device that 
does not have global unload status (N), can cause mass storage 
device status errors or permanent file errors when the device is 
spun up. 



Stops printing on the BIO equipment defined by EST ordinal est. 
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SUPPRESS,est. 



TEMP=est 1 , 
est2,...,est n . 



TERMINATE,est. 



Suppresses automatic printer carriage control on the BIO line 
printer denned by EST ordinal est. This command stops the page 
eject function on the line printer to provide a continuous listing 
for the current job. 

Reverses current set or clear condition of temporary file status for 
mass storage devices defined by EST ordinals est;. When 
temporary file status is set, the system can use the specified 
device for allocation of temporary files. This command is not valid 
if the device specified is defined as removable. Examine the disk 
status display (EM) to determine: 

• The EST ordinal of the device. 

• If the device is defined as removable. 

• If temporary file status is currently selected (set) for the 
device. 

Aborts a tape load point error recovery attempt (refer to the 
RETRY command in this section), est represents the EST ordinal 
of the tape unit where the load point error occurred. Examine the 
E,P display to determine the EST ordinal. 

The TERMINATE command also clears the error message in the 
E,P display and issues the error message to the system dayfile. 
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THRESHOLD, You can use the THRESHOLD command to set disk storage 

type=value, device thresholds for the devices defined by EST ordinals estj. 

est 1 ,est 2 ,...,est tr You must specify at least one EST ordinal. Use this command in 

conjunction with the IDLE command. You can specify one of the 
following threshold types. If no threshold type is specified, VF is 
assumed. 

type Description 

VF Verification failure threshold. Each time an unrecovered 
error occurs on a device, the system performs a device 
verification. If the error occurs again during the 
verification process and the error is in the device or in 
the only available channel or in controlled access to the 
device, the verification failure count is incremented and 
compared with the verification failure threshold. If the 
threshold is exceeded, the system sets the device's state 
to OFF. 

If the threshold is not exceeded, the device's state is set 
to IDLE to restrict allocation of new files on the device. 
Because a disk storage error can cause a job to abort, it 
is important to understand that the higher this threshold 
is set the more jobs that may abort before the system 
sets the device's state to OFF. By setting the verification 
failure threshold to a value greater than zero, you can 
continue to use a failing device. Do this only when the 
failures are relatively infrequent, the failures do not 
cause corruption of permanent files, and the device is 
essential during the next several hours of production. 
After the peak hours of production, the device can be 
repaired during a planned corrective maintenance period. 

RA Restricted activity threshold. When the available space 
on a device falls below this threshold, new files are not 
assigned to the device unless no other suitable device is 
available. 

LS Low space threshold. When the available space on a 

device falls below this threshold, the operator is notified 
on the A,OPERATOR display. 

RE Recovered error threshold. Each time a recovered error 

occurs on a disk storage device a count is incremented 
and checked against the recovered error threshold for 
that device. If the threshold is exceeded, the operator is 
notified on the A,OPERATOR display. 

UE Unrecovered error threshold. Each time an unrecovered 
error occurs on a disk storage device a count is 
incremented and checked against the unrecovered error 
threshold for that device. If the threshold is exceeded, 
the operator is notified on the A,OPERATOR display. 
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THRESHOLD, 

type=value, 

est 1 ,est 2 ,...,est n . 



(Continued) 

The threshold value can range from to 3777 8 . Specify a 
threshold value of * to obtain the default value for the specified 
type, for example, THRESHOLD,KA=*,21. The following default 
values are used. 



type 



value 



VF 

RA 1/8 of the number of tracks on the device 

LS 1/16 of the number of tracks on the device 

RE 50 8 

UE 



TRAIN,est,t. 



Assigns or changes print train identifier t of the line printer 
defined by EST ordinal est. This command can set the 
identification if it was not specified in the EQ entry of the 
EQPDECK, or change an identification previously included in the 
EQPDECK An LR designation in the EQ entry indicates a 580-12 
line printer, LS is a 580-16 line printer, LT is a 580-20 line 
printer, and LX is a 5870 printer. Print trains supported for the 
580 printers are 595-1/596-1, 595-5/596-5, and 595-6/596-6. The 
print train supported for the 5870 printer is t = 7. The t field 
specifies the print train. 



t_ 


1 
2 
3 
4 

5 
6 

7 



Description 



595-1/596-1 (CDC graphic 63/64-character set); default. 

595-1/596-1 (CDC graphic 63/64-character set). 

Reserved for future use. 7 

Reserved for future use. 7 

595-6/596-6 (ASCII graphic 63/64-character set or ASCH 
graphic 95-character set). 

595-6/596-6 (ASCII graphic 63/64-character set). 

595-6/596-6 (ASCII graphic 95-character set). 

595-6/596-6 (ASCII graphic 63/64-character set or ASCII 
graphic 95-character set). 



7. These values are allowed but will default to 595-1/596-1. 
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Description 



TRAIN,est,t. 



(Continued) 

If an invalid external characteristic (EC) 8 is specified, the queued 
file processor cannot output the file. The following shows which 
files will print and which files will not print for a given print 
train selection. 



Print 


Will Print File 


Will Not Print 


Train 


With the 


File With the 


Selected 


Specified EC 


Specified EC 





None, B4, B6 


A4, A6, A9 


1 


None, B4, B6 


A4, A6, A9 


4 


None, A4, A6, A9 


B4, B6 


5 


None, A4, A6 


B4, B6, A9 


6 


A9 


None, B4, B6, A4, A6 


7 


None, B4, B6, A4, 
A6, A9 





8. Refer to the NOS Version 2 Reference Set. Volume 3 for a discussion of the ROUTE command EC parameter. 
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UNLOAD,est. 



Physically unloads a tape or logically removes a removable disk 
storage device from the operating system. The device to be 
unloaded is denned by EST ordinal est (examine the E,A display 
to determine the EST ordinal). Also, in a multimainframe 
environment, the UNLOAD command must be issued if another 
mainframe wants to initialize a shared mass storage device, 
whether the device is removable or nonremovable (refer to the 
INITIALIZE command earlier in this section). If a magnetic tape 
is specified, the tape is physically unloaded. If a removable disk 
storage device is specified, you can dismount the disk pack on 
that device after all activity on the device has been completed. 

NOTE 

If a nonremovable shared mass storage device is to be specified, 
the console must be unlocked (refer to the UNLOCK command 
later in this section). 



Magnetic tape units: 

If a tape is currently assigned to a job, it cannot be unloaded. If 
you attempt to unload it, the UNLOAD command is ignored and 
this message appears on the left console screen: 

UNIT NOT AVAILABLE 

Examine the tape status display (E,T) before entering the 
UNLOAD command to determine if the tape to be unloaded is 
currently assigned to a job. If the tape is not currently assigned, 
entering this command unloads the specified tape. 

Mass storage devices: 

The UNLOAD command is valid for any shared mass storage 
device in a multimainframe environment for the purpose of 
initialization. Otherwise, the command is valid only for 
removable devices. (Only removable devices may be physically 
removed by unloading.) After entering the UNLOAD command, 
monitor the disk status display (E,M). Execution of this command 
immediately causes local unload (L) status to appear in the 
STATUS field for that device. While L status is displayed, no new 
users are permitted to access files on the device. A user currently 
accessing files on the device can continue while at least one direct 
access file from the device is attached to the job. When the user 
count is zero and there are no checkpoint requests pending, one of 
the following two actions occurs. 
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UNLOAD,est. 



(Continued) 

• If the device is removable and the L status is set in all 
machines accessing the device, global unload (N) status is 
displayed. This indicates that the device may now be 
physically dismounted. 

NOTE 

If a multispindle family is mounted on a single spindle 
device, only the first device shows the global unload status. 



If an initialize is pending on the device and all other 
machines accessing the device have L status set, the 
initialization proceeds. However, initialization cannot take 
place if the device has been unloaded. 

NOTE 

A device should be physically dismounted only if global unload 
status (N) is displayed on all machines accessing the device. 



If a removable pack is dismounted before the N status is 
displayed, the following may occur. 

• Mass storage device status errors. 

• Permanent file errors when the pack is remounted at some 
later date. 

• If another pack has been mounted, accesses made by a 
previously attached user may destroy information on the new 
pack or the user may retrieve information from the new 
device which he is not necessarily privileged to access. Mass 
storage device status errors are also possible in this situation. 

NOTE 

If the Mass Storage Extended Subsystem (MSE) is active, it 
must be idled before unloading a removable family pack 
which has MSE files. After dismounting the family pack, 
MSE can be initialized again. 
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Command 



Description 



UNLOAD,est. 



UP,CH=ch. 

or 

UP,MCH=ch. 9 

or 

UP,CCH=cch, 

EQ=est. 



VALIDATE,est. 



VSN,est. 



(Continued) 

Optical disk units: 

If an optical disk is currently assigned to a job, it cannot be 
unloaded. If you attempt to unload it, the UNLOAD command is 
ignored and this message appears on the left console screen: 

UNIT NOT AVAILABLE 

To determine if the optical disk to be unloaded is currently 
assigned to a job, examine the optical disk status display (E,S) 
before entering the UNLOAD command. 

If the optical disk is not currently assigned, entering this 
command unloads the specified optical disk. 

The first two forms of the command allow resumption of normal 
use of channel ch by magnetic tape units or mass storage devices, 
reversing the effects of the DOWN command. 

The third form of the command allows resumption of normal use 
of both ports of concurrent channel cch for the mass storage device 
specified by EST ordinal est. If the EQ=est parameter is omitted, 
channel cch resumes normal use for all devices in the EST. 

If you enter UP for a channel (ch or cch) that is already UP, the 
following message appears on the console: 

INCORRECT ENTRY 

If the channel is already up, no further action is necessary. 

Causes validation of mass storage tables associated with the 
equipment defined by EST ordinal est. The equipment must be 
available mass storage and the MS VALIDATION option must 
have been selected in the IPRDECK at deadstart. 

Reverses the effect of a previous VSN,est,vsn command, and 
forces the magnetic tape subsystem to read the label on the tape. 
This command is not allowed on ACS tape units. 



9. Model 176 only. 
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Command Description 



VSN,est,. Declares the tape mounted on an unassigned magnetic tape unit, 

denned by EST ordinal est, to be a scratch tape. This command is 
similar in function to the SCRATCH command in that it enables 
a tape to be available to satisfy scratch VSN requests. However, 
if the tape is labeled and a write function is performed, the VSN 
specified in the VOL1 label will be rewritten as a scratch VSN, 
destroying the original VSN and making the tape available for 
future scratch VSN requests. The VSN also appears as ***est (est 
is the ordinal of the est) on the tape status display (E,T). Refer to 
the VSN,est,vsn command, next, for a discussion of the 
INCORRECT ENTRY message, which is also applicable to 
VSN,est,. This command is not allowed on ACS tape units. 

VSN,est,vsn. 10 Assigns VSN vsn to an unassigned magnetic tape unit defined by 

EST ordinal est. This command allows you to specify a 1- to 
6-character VSN for a mounted, unlabeled tape so it may be 
assigned and referenced automatically. For example, when a job 
specifies a VSN in the request for an unlabeled tape, an entry for 
that job appears in the resource requests display (E,P). This 
display indicates the job sequence name of the job; the type of 
tape unit, 7-traek (MT), 9-track (HD, PE, or GE), or CTS 
cartridge (CT), on which the tape is to be mounted; the required 
VSN; the user name of the job; and the required write ring status 
(IN or OUT). If the correct tape is not currently mounted, mount 
the tape on an available unit (ensuring that track type and write 
ring status are correct), ready the unit, and enter this command. 
The system equates the VSN you enter with that specified by the 
job and assigns the tape automatically upon demand. This 
command is not allowed on ACS tape units. 



If the tape mounted on the tape unit defined by EST ordinal est is 
a labeled tape, has already had a VSN assigned by console 
command, or has not yet been checked for a label by the magnetic 
tape subsystem, this command is ignored. The message 



INCORRECT ENTRY 



appears on the left console screen. To change a VSN previously 
assigned by this command, clear the first VSN by entering: 



VSN, est. 



est Description 



est EST ordinal of the tape unit. 



10. Special characters cannot be entered using this command. If a special character is encountered in vsn, the VSN entered is 
truncated at the character preceding the special character. 
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VSN,est,vsn. 



(Continued) 

This command can then be entered: 

VSN, est.vsn. 

Parameter Description 



est 
vsn 



EST ordinal of the tape unit. 

New VSN. 



(The preceding message and procedure for changing a VSN are 
also applicable to the VSN.est,. command.) 

If a job specifies a VSN in the request for a labeled tape, 
assignment occurs automatically, without your intervention, 
unless the correct tape is not mounted. In this case, an entry is 
formed in the resource requests display (E,P), which describes the 
tape to be mounted. When the tape is mounted and the tape unit 
made ready, assignment occurs automatically without additional 
intervention by you. For multivolume files, automatic tape 
assignment occurs only if the tape units on which the tapes are 
mounted are similar and on the same channeKs). That is, if the 
first volume of the file is on a 669 tape unit on channels 13 and 
33, all subsequent volumes must be on a 669 unit on channels 13 
and 33. When assigning tapes, models 679-2, 679-3, and 679-4 
drives (800/1600 cpi) are similar. Also models 679-5, 679-6, and 
679-7 drives (1600/6250 cpi) are similar. All CTS tape units are 
similar and all ACS tape units are similar. 

If two or more unassigned tapes having identical VSNs are 
mounted on units of the same tape type, the message 

REQUEST , dt , vsn 

appears on the B,0 and B A displays. The dt field is either a 
device type (CT or MT) or a density requirement (HD, PE, or GE); 
vsn is the VSN required. 

You must assign one of the tapes using the ASSIGN command. If 
the duplicate VSNs are SCRATCH, the resource executive routine 
assigns one automatically. 

NOTE 

It is not possible to specify a VSN of SCRATCH with this 
command since only six characters may be used to define a VSN. 
To define a scratch tape (used to satisfy scratch VSN requests), 
refer to the description of the SCRATCH command earlier in this 
section. 
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Subsystem Control Commands 

The commands that follow provide control over which subsystems are to be used. When a 
system deadstart is performed, parameters specified in the IPRDECK determine which 
subsystems initially are available. Scheduling other subsystems to a control point or 
terminating a current subsystem depends on your action. 

When a subsystem is scheduled to a specific control point, any job currently assigned to that 
control point is rolled out if it is not another subsystem or special system job. If the job 
currently assigned to the control point is another subsystem or cannot be rolled out, the new 
subsystem waits for the control point to become free. In this case, either terminate the job 
(if the subsystem requires that control point) or specify another control point for the 
subsystem using the SUBSYST L-display utility (refer to section 9, L-Display Utilities, for 
more information). 



Command 



BIO. 



Description 



Calls the Batch Input/Output (BIO) Subsystem. BIO must be 
active in order to use any of the local batch peripheral devices. 
BIO equipment activity can be monitored on the I display (refer 
to the NOS Version 2 Operations Handbook). 

Response to line printer errors is controlled by setting sense 
switch 1 or 2 as follows: 



Entry 



Response 



ONSW,BIO,l. Lines causing print error messages are not 
flagged or retried. 

ONSW,BIO,2. Lines causing print error messages are flagged 
and retried. The printer halts and is placed on 
hold until you correct the error and enter 
CONTINUE,est. The line reprints and printing 
continues. 



CDCffff. 11 



CYBffff. 11 



IAFffff. 11 



Calls the CYBER Database Control System (CDCS). CDCffff calls 
a procedure file named CDCffff under the system user index to 
initiate the CDCS Subsystem. 

Calls the CYBIS-NAM Interface (CYB) Subsystem to the control 
point specified in the IPRDECK or by the SUBSYST L-display 
utility. CYBffff calls a procedure file named CYBffff under the 
system user index to initiate the CYB Subsystem. 

Calls the Interactive Facility (IAF) Subsystem to control point 1. 
IAFffff calls a procedure file named IAFffffunder the system user 
index to initiate the IAF Subsystem. The IAF Subsystem must be 
active before jobs can be entered from an interactive terminal. 
Use the T display to monitor activity at the IAF Subsystem 
control point. 



11. The characters ffff are optional; if required, installation personnel must supply the necessary 1 to 4 alphanumeric characters. 
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Description 



IAFfiff. 



(Continued) 

Several options are available to control the operation of IAF. 
Select these options by setting sense switches after the subsystem 
is initiated. Although normal operation does not require these 
sense switches to be set, sense switch 5 (ONSW,IAF,5) is set by 
default when the IAF Subsystem is initiated. Once set, the sense 
switches may be turned off again by entering OFFSW,IAF,s (s is 
the sense switch number.) 



Entry 



Response 



ONSW,IAF,l. When the IAF Subsystem is terminated (by an 
IDLE,IAF command), enter users into a 
detached state and inhibit restarting operations. 

ONSW,IAF,2. The IAF Subsystem will not reload after an 

abort. This option releases the output file to the 
output queue. 

ONSW,IAF,3. Aborts the IAF Subsystem on all abnormal 
conditions. This ensures that the subsystem 
does not continue to operate if an internal 
malfunction occurs. This may be used with 
sense switch 5 to enable an analyst to determine 
the problem. Some conditions cause the IAF 
Subsystem to abort even though sense switch 3 
is not set. 

ONSW,IAF,4. Enables a dump on normal termination. This 
option should be activated whenever a dump is 
desired after the IDLE,IAF command. 

ONSW,IAF,5. Dumps information to the output file after the 
IAF Subsystem is dropped or aborted. This 
option provides a listing that may assist an 
analyst in determining the problem that existed 
when the subsystem dropped or aborted. This 
sense switch is set by default when the IAF 
Subsystem is activated. 

ONSW,IAF,6. Releases the output file containing dump 

information written after the IAF Subsystem is 
dropped or aborted (refer to the ONSW,IAF,5 
option) immediately after the dump is taken. 
When sense switch 6 is not set, the output file is 
not released until the IAF Subsystem is 
terminated. It is then printed with the job 
dayfile. This switch applies only when sense 
switch 5 is set. 
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Command 



Description 



IDLE,sub. 



MAGffff. 12 



MAPflST. 12 



MCSffff. 12 



Sets idledown status for subsystem sub. 
NOTE 



Do not use this command to idle the NAM subsystem. NAM is 
idled by using the procedure shown in NAM Shutdown (refer to 
section 15, Network Operations). 

The subsystem terminates when idledown conditions are met. 
MAG terminates when no tapes are assigned. MSE terminates 
when no requests are outstanding and no MSE utilities are 
connected. BIO terminates when no active equipments remain. 
TAF terminates when no active transactions are outstanding. For 
all other subsystems, there are no idledown conditions; they 
terminate immediately. 

The system does not initiate new activity, such as assigning tapes 
and beginning print jobs, when idledown status is set. It is 
recommended that you use this command for terminating all 
subsystems. 

Calls the Magnetic Tape Subsystem (MAG) to the control point 
specified in the IPKDECK or by the SUBSYST L-display utility. 
MAG must be active in order for tape processing and resource 
allocation to take place and to make the resource requests 
available. Tape use can be monitored on the tape status (E,T) and 
resource requests (E,P) displays. MAGffff executes a procedure 
file named MAGffff under the system user index to initiate the 
MAG Subsystem. 

NOTE 

You must not change unit numbers or power down tape units 
after MAG is initialized. Also, MAG should not be stopped (via 
the STOP command) while tapes are assigned. The IDLE 
command should be used instead. 

Calls the Matrix Algorithm Processor (MAP) Subsystem to the 
control point specified in the IPRDECK or by the SUBSYST 
L-display utility. MAPffff calls a procedure file named MAPffif 
under the system user index to initiate the MAP Subsystem. 

Calls the Message Control System (MCS) to the control point 
specified in the IPRDECK or by the SUBSYST L-display utility. 
MCSfiff calls a procedure file named MCSfiff under the system 
user index to initiate the MCS Subsystem. NAM must be active 
at a control point to use MCS. 



12. The characters ffff are optional: if required, installation personnel must supply the necessary 1 to 4 alphanumeric characters. 
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MSEffff. 13 



Description 



Calls the Mass Storage Extended Subsystem (MSE) processing 
program to the control point specified in the IPRDECK or by the 
SUBSYST L-display utility. MSEffff calls a procedure file named 
MSEffff under the system user index to initiate the MSE. 

You can turn the trace mode on or off by using the following 
sense switch entries after the subsystem is initiated. 



Entry 



ONSW,MSE,l. 



OFFSW,MSE,L 



Response 



Turn the trace mode on. The trace mode issues 
all MSE messages to the job dayfile. 

Turn the trace mode off. Default is trace mode 
off. 



NAMffff. 13 



RDFffff. 13 



Calls the network access method (NAM) to the control point 
specified in the IPRDECK or by the SUBSYST L-display utility. 
NAMffff calls a procedure file named NAMffff under the system 
user index to initiate several NAM supervisor modules. These 
modules appear momentarily at different control points as needed 
during NAM activity. 

The release versions are NAM and NAMNOGO. Use NAM if you 
want to initialize the network with no operator intervention. Use 
NAMNOGO if you want to alter the memory file. Refer to section 
15, Network Operations, for more information. 

Additional commands that you can enter during NAM initiation 
are also described in section 15, Network Operations. 

Calls the Remote Diagnostic Facility (RDF) Subsystem to control 
point 1. RDFffff calls a procedure file named RDFffff or IAFffff 
(depending upon whether the site has the IAF enabled) under the 
system user index to initiate the RDF Subsystem. 

If your site uses IAF, ensure that NAM is active at a control point 
(refer to the B,0 or B,A display) before you enter the RDFffff 
command. 



13. The characters ffff are optional; if required, installation personnel must supply the necessary 1 to 4 alphanumeric characters. 
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Description 



RHFffff. 



14 



SMFffif. 14 



SSFffif. 14 



STMffff. 14 



STOP,sub. 



Calls the Remote Host Facility (RHF) Subsystem to the control 
point specified in the IPRDECK or by the SUBSYST L-display 
utility. RHFffif calls a procedure file named RHFffif under the 
system user index to initiate the RHF Subsystem. 

Calls the Screen Management Facility (SMF) Subsystem to the 
control point specified in the IPRDECK or by the SUBSYST 
L-display utility. SMFffff calls a procedure file name SMFffff 
under the system user index to initiate the SMF Subsystem. IAF 
must be active to use SMF. 

Calls the SCOPE 2 Station Facility (SSF) Subsystem to the 
control point specified in the IPRDECK or by the SUBSYST 
L-display utility. SSFffif calls a procedure file named SSFffif 
under the system user index to initiate the SSF Subsystem. 

Calls the stimulator to the last control point. STMffff calls a 
procedure file named STMffff under the system user index to 
initiate the stimulator. 

Drops (terminates) the subsystem sub. Any acceptable 
three-letter subsystem name can be specified. Unlock the console 
to enter this command. This command can cause termination 
errors in the subsystem being dropped. The IDLE,sub command 
does the same thing without the termination errors. 



14. The characters ffff are optional; if required, installation personnel must supply the necessary 1 to 4 alphanumeric characters. 
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TAFffiff. 15 



Calls the Transaction Facility (TAF) Subsystem to the control 
point specified in the IPRDECK or by the SUBSYST L-display 
utility. TAF must be active for transaction processing to take 
place. 

TAFflff calls a procedure file named TAFfHf under the system 
user index to initiate the TAF Subsystem. NAM must be active at 
a control point for interactive access to TAF. Batch jobs can 
access TAF without NAM. 

Response to an operator drop or fatal error is controlled by setting 
sense switches as follows: 



Entry 



Response 



ONSW,TAF,3. Attempt recovery after TAF is dropped or 

aborted. To successfully drop the transaction 
subsystem once this entry has been made, the 
command OFFSW,TAF,3 must be entered prior 
to the IDLE,TAF command. 

ONSW,TAF,4. Automatically restart TAF after a recovery. 

ONSW,TAF,5. Dump the entire field length and release the 
output file after the transaction subsystem is 
dropped or aborted. 

ONSW,TAF,6. Print the job dayfile upon termination. 

Activity at the transaction control point can be monitored on the 
O displays (refer to the NOS Version 2 Operations Handbook). 

Refer to the AUTO and MAINTENANCE commands in this section and the SUBSYST L 
display in the NOS 2 Operations Handbook for additional information concerning subsystem 
control. 



15. The characters ffff are optional; if required, installation personnel must supply the necessary 1 to 4 alphanumeric characters. 
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System Control Commands 

The following DSD commands control the operating system as well as the subsystems that 
run under the system. Several of these commands are typically used only for debugging 
purposes when the system is in an abnormal state. You may use others frequently to 
maintain system integrity in a normal production environment. Appropriate cautions are 
included with individual command descriptions in cases where you do not normally use the 
command or it is not recommended for use in a production environment. 



Command 



Description 



AUTO. 



CHECK POINT 

SYSTEM. 



Calls enabled subsystems to control points, initiates automatic job 
processing, and spins up any 834, 836, 887, or 9853 disk drive 
that is ON and not unloaded. The IPRDECK used at deadstart 
time determines which subsystems will be activated by default. 
However, any of those subsystems not currently assigned to a 
control point can be disabled or others enabled through use of the 
SUBSYST L display (refer to the NOS Version 2 Operations 
Handbook). Individual subsystems can also be called to a control 
point or removed independent of the AUTO command by using the 
Subsystem Control Commands described earlier in this section. 
For additional information concerning the AUTO command, refer 
to Initiating Job Processing in section 2, Deadstart. 

Provides for tennination of job processing and writes the contents 
of central memory tables to mass storage. The SCKP EQPDECK 
entry specifies which mass storage devices will contain a copy of 
the checkpoint file. This command is typically entered in 
preparation for recovery deadstart. The following sequence of 
operations takes place: 

1. Sense switch 1 is set for the IAF Subsystem, which causes all 
users to be placed in detached job status when an operator 
drop occurs. When all users are in detached job status, the 
IAF Subsystem is dropped and the checkpoint continues. 

2. All job scheduling is inhibited. (This has the same effect as if 
the IDLE command was entered.) 

3. Jobs with a zero subsystem identifier are rolled out. All of 
these jobs are recovered on a level 1 or level 2 recovery 
deadstart. 

4. The system moves the system dayfile buffers maintained in 
CMR to disk. 

5. All subsystems except the magnetic tape executive (MAG) are 
aborted. 
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CHECK POINT 
SYSTEM. 



DATE.yy/mm/dd. 



(Continued) 

6. MAG is rolled out when no other jobs are active. The rolling 
out of MAG allows recovery of all tape files associated with 
jobs rolled out if the tapes are not repositioned prior to the 
level 1 or level 2 recovery deadstart. Because of this, if a tape 
unit is used for deadstart, it should be unassigned prior to 
the checkpoint command. 

7. The system is left in an idle state. If SPINDOWN is enabled, 
all 834, 836, 887, or 9853 disk drives that are ON and not 
unloaded are spun down. Normal processing may be 
continued with an AUTO command. If this is done, no 
attempt should be made to later perform a level 1 or level 2 
recovery deadstart unless another checkpoint command is 
performed. 

During the processing of the checkpoint, the message 

PROCESSING SYSTEM CHECKPOINT 

is issued at the system control point. It is also possible that under 
certain circumstances the checkpoint routine will not be able to 
properly abort a job (such as one that has NOEXIT selected and 
has a nonzero subsystem identifier). If such a job continues 
processing after it has been aborted by the system, the operator 
must then abort the job for the checkpoint to continue. A more 
desirable approach to this situation is to ensure that jobs such as 
permanent file dumps are finished prior to the checkpoint. For 
additional information concerning the CHECK POINT SYSTEM 
command, refer to Preparing for Recovery Deadstart in section 2, 
Deadstart. 

Changes the current system date. Unlock the console before 
entering this command (refer to the UNLOCK command later in 
this section). 



Parameter 

yy 



mm 
dd 



Description 



Year; 70 through 99 (corresponds to the years 1970 
through 1999) or 00 through 33 (corresponds to the 
years 2000 through 2033). 



Month; 01 through 12. 
Day; 01 through 31. 
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Command 



Description 



DEBUG. 



DISjsn. 



Reverses the current status of the debug mode. When the debug 
mode is set, the message DEBUG appears in the header of the 
left screen display. The debug mode provides system origin 
privileges to validated users and allows modifications to be made 
to the running system. Unlock the console before entering this 
command (refer to the UNLOCK command later in this section). 
Use of the debug mode is not commonly allowed in a normal 
production environment. 

NOTE 

On a secured system, the console must be in security unlock 
status to accept this command (refer to the 
UNLOCK,username,password command later in this section). 

Calls the job display package (DIS) to the job with job sequence 
name jsn. The A and B displays for DIS automatically appear on 
the left and right console screen, respectively. Unlock the console 
before entering this command (refer to the UNLOCK command 
later in this section). Refer to section 4, DIS Operations, for 
complete information concerning the DIS package. 

NOTE 

On a secured system, the console must be in security unlock 
status to accept this command (refer to the 
UNLOCKusername,password command later in this section). 
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Command 



Description 



DISABLE,op. 

or 

ENABLE,op. 



Disables or enables option op. 

If you enter the ENABLE command and op is currently enabled, 
the system ignores the command. The system also ignores the 
DISABLE command if you enter it and op is already disabled, op 
is one of the following options: 



2E 

ACS TAPE PF 
STAGING 



AUTORESTART 



CARTRIDGE PF 
STAGING 



DDP ROLLOUT 
PATH 



Description 



Enables or disables the staging of 
Automated Cartridge Subsystem (ACS) 
tape alternate storage resident files to 
disk. If disabled, jobs attempting to access 
permanent files that reside only on ACS 
tapes are aborted. This entry controls 
staging of files from ACS tapes, whereas 
the TAPE PF STAGING entry controls 
staging of files from 9-track tapes and 
CTS tapes. 

Enables or disables the AUTORESTART 
installation parameter. If 
AUTORESTART is enabled and if step 
mode is set during an environmental 
shutdown, the system automatically clears 
step mode when the power environment 
returns to normal. All jobs waiting in the 
input queue are initiated by performing 
the processing associated with the AUTO 
command described earlier in this section. 
This recovery process requires no operator 
action. 

Enables or disables the staging of MSE or 
optical disk permanent files to disk. 
Disabling CARTRIDGE PF STAGING 
aborts jobs that attempt to access files 
residing only on either MSE or optical 
disk. Enabling CARTRIDGE PF 
STAGING allows both MSE and optical 
disk files to be staged to disk when 
accessed. Contrast this entry with the 
ACS TAPE PF STAGING entry, which 
enables or disables staging from ACS 
tapes, and the TAPE PF STAGING entry, 
which enables or disables staging from 
9-track tapes and CTS tapes. 

Enables or disables the use of the DDP for 
job rollout and rollin. If DDP or EM 
equipment is not present, this entry has 
no effect. 

(Continued on next page) 
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Description 



(Continued from previous page) 

(Continued) 



DISABLE,op 

or 

ENABLE,op. 



2EL 



ENGR 16 



FLEXIBLE 
PARTITIONS 



FORCED 
FORMATTING 



LOGGING 



Description 



Enables or disables engineering mode. 
When engineering mode is set, the 
message ENGR appears in the header of 
the left screen display. Engineering mode 
allows PP/hardware diagnostics and 
FORMAT/FDP to be executed if the user 
has system origin privileges. Unlock the 
console before entering this command 
(refer to the UNLOCK command later in 
this section). 

Enables or disables flexible memory 
partitioning. The job scheduler attempts 
to use memory space to the greatest 
extend possible when flexible partitions 
are enabled. Some service classes may be 
allotted more total memory space than 
memory partitioning constraints normally 
allow. If flexible partitions are disabled, 
the total memory used by jobs of a given 
service class is never allowed to exceed 
the maximum specified on the SERVICE 
command (AM and EM parameters). 

Enables or disables forced formatting of 
583x devices. When FORCED 
FORMATTING is enabled, the driver 
reformats the devices when either you 
specify the INITIALIZE,FP option for the 
device, or the system detects that a 
previously offline parity drive is now 
online. The driver does not determine 
whether the device is already formatted 
correctly. 

When FORCED FORMATTING is 
disabled, the driver formats the device 
only when necessary. 

Enables or disables logging of dayfile 
messages concerned with program 
efficiency. 



(Continued on next page) 



16. On a secured system, the console must be in security unlock status to accept this 
command (refer to the UNLOCK.usemame,password command later in this section). 
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Command 



Description 



(Continued from previous page) 
DISABLE,op. (Continued) 



or 

ENABLE,op. 



op_ 



MASTER MSE 



MS VALIDATION 



PF VALIDATION 



PRIVILEGED 
ANALYST MODE 



Description 



Enables or disables master mainframe 
mode for MSE processing. When MSE is 
brought to a control point, the SSEXEC 
program runs if master mainframe mode 
is enabled. The SSSLV program runs if 
master mainframe mode is disabled. This 
entry has no effect unless MSE processing 
is activated. 

Enables or disables automatic verification 
of mass storage tables. This command 
cannot be used unless the MS 
VALIDATION option has been selected in 
the IPRDECK used at deadstart. The 
validation that occurs for each level of 
recovery deadstart is described under 
Preparing for Recovery Deadstart in 
section 2, Deadstart. 

Enables or disables verification of 
BOI/EOI on preserved files. Selection of 
this option causes BOI/EOI information to 
be verified when a direct access file is 
attached or purged, and when an existing 
local file is defined as a direct access 
permanent file. 

Enables or disables PRIVILEGED 
ANALYST MODE operations. When 
enabled, a user validated with AW-CPAM 
(refer to the NOS Version 2 
Administration Handbook for information 
on MODVAL validation) is permitted to 
read system status information (such as 
the system dayfile, account file, and error 
log) using a nonsystem-origin job. Unlock 
the console (refer to the UNLOCK 
command later in this section) to enable 
or disable this option. This command is 
not accepted on a secured system. 

(Continued on next page) 
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Description 



(Continued from previous page) 
DISABLE,op. (Continued) 



or 
ENABLE,op. 



op_ 



Description 



PRIVILEGED RDF 



REMOVABLE 
PACKS 



RESIDENT RDF 



SECONDARY 
USER COMMANDS 



SPINDOWN 



Enables or disables privileged mode of the 
Remote Diagnostic Facility (RDF). When 
enabled, a user's commands are checked 
to ensure that a maintenance function is 
being performed. 

Enables or disables automatic label 
checking for mass storage devices defined 
as removable. Examine the disk status 
display (E,M) (refer to the NOS Version 2 
Operations Handbook) to determine which 
mass storage devices (if any) are denned 
as removable. If this option is disabled, all 
removable devices subsequently 
introduced into the system cannot be 
accessed. This option must be enabled to 
perform label verification before those 
devices can be accessed. 

Enables or disables resident mode of RDF. 
While in resident mode, RDF remains 
active, regardless of terminal activity, 
until you disable RDF. When resident 
mode is disabled (the default condition), 
RDF becomes inactive if no one logs into 
the remote diagnostic terminal for 15 
minutes. To allow terminal activity to 
resume, you must reactivate RDF with a 
call to RDFfffi 

Enables or disables the acceptance of 
more than one USER command in a job. 
If disabled, any USER command 
encountered after the first one causes the 
job to be aborted. Unlock the console 
(refer to the UNLOCK command later in 
this section) to enable or disable this 
option. This command is not accepted on a 
secured system. 

Enables or disables the spinning down of 
834, 836, 887, and 9853 disk storage 
devices during a system checkpoint. 
System checkpoints that are initiated by 
mainframe errors do not affect the state of 
these devices. 



(Continued on next page) 
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(Continued from previous page) 

DISABLE,op. (Continued) 

or 

ENABLE,op. 



2E 

SYSTEM DEBUG 



Description 



Enables or disables the system debug 
mode of operation. Unlock the console 
(refer to the UNLOCK command later in 
this section) to enable or disable this 
option. 

When the system is in system debug 
mode, it is less tolerant of system errors; 
that is, it is more likely to hang upon 
experiencing errors. When the system is 
not in system debug mode, it rates system 
errors as critical or noncritical. 

For critical errors, the system partially or 
totally interrupts system operation to tend 
to the errors. For noncritical errors, the 
system logs them in the binary 
maintenance log (BML) and inasmuch as 
possible allows system operation to 
proceed. You can initiate the system 
debug mode with the DSD ENABLE 
command or the corresponding IPRDECK 
entry. 

There is another system state called 
debug mode which is conceptually 
different from that of system debug mode. 
Debug mode is the state of the system 
where a user with system origin privileges 
can make modifications to the running 
system. You can initiate this mode of 
operation with the DSD command 
DEBUG. The left screen header of the 
system console indicates whether the 
system is in debug mode or not. 

(Continued on next page) 
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Description 



(Continued from previous page) 



DISABLE,op. 

or 

ENABLE,op. 



(Continued) 
22 



Description 



TAPE PF STAGING 



USER EXTENDED 
MEMORY 



Enables or disables the staging of tape 
alternate storage resident files to disk. 
The media for tape alternate storage is 
9-track tapes and CTS tapes. Disabling 
TAPE PF STAGING aborts jobs that 
attempt to access files residing only on 
tape alternate storage. This entry controls 
staging of files from 9-track tapes and 
CTS tapes. Contrast this entry with the 
ACS TAPE PF STAGING entry, which 
controls staging of files from ACS tapes, 
and the CARTRIDGE PF STAGING 
entry, which controls staging of files from 
MSE and optical disk. 

Enables or disables use of the user 
accessible area of extended memory. If 
disabled, no job can access the user area 
of extended memory and, other than 
subsystems, all jobs currently accessing 
the area are rolled out. 



IDLE. 



Kmessagetext. 



L.messagetext. 



LOCK 



Prevents any new jobs from being scheduled to a control point but 
does not terminate the jobs currently assigned. If a job is rolled 
out while this command is in effect, it will not be scheduled back 
to a control point until the AUTO, MAINTENANCE, or 
SCHEDULE command is entered. 

Allows entry of data messagetext in the user- or system-defined 
CPU buffer for control when the K display is active. Refer to 
section 8, K-Display Utilities, for information about the K display. 

Allows entry of data messagetext in the user- or system-defined 
CPU buffer for control when the L display is active. Refer to 
section 9, L-Display Utilities, for information about the L display. 

Locks the console keyboard. This command prevents entry of 
restricted commands (refer to the UNLOCK command later in 
this section for a fist of restricted commands). All other DSD 
commands can be entered when the console is locked. The console 
is normally locked when the system is being used in a production 
environment. 
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(Continued from previous page) 

MAINTENANCE. This command performs the same functions as the AUTO 

command but additionally starts several maintenance routines. 
Refer to Initiating Job Processing in section 2, Deadstart, for 
complete information concerning this command. 



SCHEDULE. 



STEP. 



Initiates automatic job processing (reversing the effect of a 
previous IDLE command), but does not initiate subsystems as the 
AUTO command does. 

Sets the monitor in step mode. Setting the monitor in step mode 
stops all central memory I/O operations and prevents the system 
from processing PP requests when the next monitor function is 
encountered. Pressing the space bar releases the present step and 
stops again for each subsequent monitor function. 17 If a DSD 
command is entered while the system is in step mode and all PPs 
are assigned, it is possible the request cannot be satisfied. In that 
case, the screen(s) blinks until you correct the condition by 
clearing the entry. 

When step mode is set, the message STEP appears in the header 
of the left screen display. Unlock the console before entering this 
command (refer to the UNLOCK command later in this section). 

This command is generally used for debugging purposes and 
should not be used in a normal production environment. In 
addition, the system may set step mode automatically upon 
detection of a main power failure or abnormal environmental 
condition. 



(Continued on next page) 



17. Monitor functions are described in the NOS Version 2 Systems Programmer's Instant. 
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(Continued from previous page) 

STEPjsn,ff,b,v. Sets step mode for the job with job sequence name jsn (first form 



or 
STEP„ff,b,v. 



TIME.hh.mm.ss. 



of the command) or all jobs (second form of the command) at the 
next occurrence of monitor function fif when output register byte b 
has value v. 

If jsn is specified (first form of the command), the monitor 
function fif, the output register byte number b, and the output 
register value v can be optionally specified for more precise 
control of when the step mode is executed. The values for b can 
be from to 4; the values for v can be from to 7777 8 . 

If jsn is not specified (second form of the command), the monitor 
function fif must be specified. The output register byte number b 
and value v can be optionally specified for more precise control of 
when the step mode is executed. The values for b can be from to 
4; the values for v can be from to 7777 g . 

For either form of the command, pressing the spacebar releases 
the current step and steps the job or system at the next 
occurrence of the monitor function ff, if specified, or the next 
monitor function from the job if the first form is used and no 
monitor function is specified. 

Using the second form of the command may stop all central 
memory I/O operations and prevent the system from processing 
PP requests. If a DSD command is entered while the system is in 
step mode and all PPs are assigned, it is possible the request 
cannot be satisfied. In this case, the screens blink until you clear 
the entry. The message STEP followed by the monitor function 
number ff (if specified) appears in the header of the left screen 
displays while this command is in effect. The console must be 
unlocked before entry of this command is permitted (refer to the 
UNLOCK command later in this section). 

These commands are generally used only for debugging purposes. 
Do not enter these commands if the system has automatically set 
step mode because of a power failure or abnormal environmental 
condition. 

Changes the current system time. Unlock the console before 
entering this command (refer to the UNLOCK command later in 
this section). 

Parameter Description 



hh 
mm 

ss 



Hour; 00 through 23. 
Minute; 00 through 59. 
Second; 00 through 59 



(Continued on next page) 
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(Continued from previous page) 

UNLOCK Unlocks the console keyboard. When this command is active, the 

message UNLOCK appears in the header of the left screen 
display. Although all DSD commands can be entered when the 
console is unlocked, the following commands are restricted to 
entry only when the console is unlocked. 

DATE.yy/mm/dd. 18 

DEBUG. 

DISABLE.PRIVILEGED ANALYST MODE. 19 

DISABLE,SECONDARY USER COMMANDS. 19 

DISABLE,SYSTEM DEBUG. 

DROP„qt,ujn. 

ENABLE,ENGR. 18 

ENABLE,PRIVILEGED ANALYST MODE. 19 

ENABLE,SECONDARY USER COMMANDS. 19 

ENABLE,SYSTEM DEBUG. 

OVERRIDEjsn. 

SPINDOWN,est. 

STEP. 

STEPjsn,ff,b,v. 

STOP,sub. 

TIME.hh.mm.ss. 18 

UNLOAD,est. (est specifies a nonremovable shared mass 
storage device) 

All memory entry commands 18 

All channel control commands 

All extended memory flag register commands 

All breakpoint package commands 18 



(Continued on next page) 



18. Refer to Secured System Control Commands later in this section for information on unlocking the console keyboard on a 
secured system. 

19. Not allowed on secured systems. 
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(Continued from previous page) 
UNLOCK. (Continued) 



UNSTEP. 



XMDD(p). 



X.name. 

or 

X.name(parameters). 

or 

X.name,fl. 



Always lock the console when the system is being used in a 
production environment. However, you can unlock the console to 
enter the STEP command if a system failure requiring a recovery 
deadstart occurs (refer to Preparing for Recovery Deadstart in 
section 2, Deadstart). 

Refer to Secured System Control Commands later in this section 
for information on unlocking the console keyboard on a secured 
system. 

Clears step mode. This command clears the effect of any format 
of STEP command. If the system has set step mode because of a 
main power failure or abnormal environmental condition, do not 
enter this command until the conditions that caused the 
automatic setting have returned to normal. 

Initiates the monitor display driver (MDD). MDD is a PP program 
and is independent of the operating system. Refer to the CYBER 
Initialization Package User's Handbook for more information. 

Parameter Description 

p Port number parameter. If you enter 1, the first 

port is connected. If you enter 2, the second port is 
connected. If you do not specify this parameter, 
the second port is connected by default. 

Calls a system program or utility specified by name to an 
available control point. If parameters are to be passed to the 
program, the second form of the command is used. In both the 
first and second form of the command, the field length specified in 
the library for the command is used. If no field length is specified 
in the library, a value of 60000 8 is assumed. If a field length 
different from the default is required, the third form of the 
command is used. The field length is specified by fl. Only the first 
58 characters following X. are used. 

(Continued on next page) 
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(Continued from previous page) 

99. Disables or enables syntax overlay processing and logging of DSD 

commands in the system dayfile and error log. That is, depending 
upon current status, syntax overlay processing and logging are 
reversed. When this mode is enabled, 99 appears on the left 
screen header. 



When syntax overlay processing and logging of DSD commands is 
disabled, DSD does not allow you to enter any command 
requiring the loading of an overlay from mass storage. Disable 
overlay loading only when the system is in an abnormal state to 
prevent PPs from being requested when they cannot perform the 
necessary tasks (for example, when a system disk channel is 
hung). A 99 command that enables logging will be logged itself, 
but a 99 command which disables logging will not be logged. 

This command is normally used only for debugging purposes. 
When the system is in an abnormal state, the commands that 
require entry of the 99 command depend on which syntax 
overlays for DSD are in central memory. 
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Secured System Control Commands 

The following commands are allowed only on a secured system. 



Command 



Description 



OQSH=level. 



RELEASE jsn. 



SECURES,ot, 

LA=lowerlevel, 

UA=upperlevel. 



Specifies the output queue special handling (OQSH) level on a 
secured system. The (OQSH) level is set initially during deadstart 
by the OQSH IPRDECK entry. The current OQSH level appears 
on the DSD S display. The OQSH command can be entered at 
any time from the system console to change the current level. 
Output files with an access level greater than or equal to the 
OQSH level specified in this command are not printed but remain 
in the queue until released by the operator (refer to the 
RELEASE command, next). If level is set to the lowest access 
level or no level is specified, no files are held in the queue. 

Allows the operator to release a file from the output queue whose 
access level is equal to or above the OQSH level on a secured 
system. Output queue files and their access levels can be 
examined using the DSD Q display. The output file with job 
sequence name jsn is released from the output queue and is 
processed by the Batch Input/Output Subsystem. The RELEASE 
command can be entered at any time from the system console. 
Other restrictions based on device access levels and file access 
levels set by your site continue to apply. 

Sets the security access level limits for the system (ot=SY) or the 
security access level limits for a particular origin type (ot=LA BC, 
or RB). The system limits determine the range of access levels 
allowed in the system; jobs may not execute at an access level 
outside this range, and files may not be created or accessed at an 
access level outside this range. Origin type limits determine the 
range as it applies to jobs of one particular origin type. By 
default, all origin type limits are the same as the system limits. 

The options available for using this command to change the 
system limits (that is, whether they can be raised, lowered, or 
both) are controlled by the OPSECM CMRDECK entry (refer to 
section 3, Deadstart Decks). The origin type limits for ot=IA, BC, 
and RB can be changed to any values within the system limits. 
When the system limits are changed (ot=SY), all origin type 
limits are reset to the new system limits. 

The parameters LA and UA specify the lower and upper access 
level limits. Both parameters must be specified. The value 
corresponding to the lower access level must be less than or equal 
to the value corresponding to the upper access level. 



5-70 NOS Version 2 Analysis Handbook 



60459300 U 



Secured System Control Commands 



Command Description 



UNLOCK,username, Unlocks the console keyboard for special commands when the 
password. system is running in secured mode. When this command is 

entered, the message SECURITY UNLOCK appears in the 
header on the left screen display. If the system is ru nn ing in 
secured mode, the following commands are restricted to entry 
only when the console is in security unlock status. 

DATE.yy/mm/dd. 

X.DDF. 

DEBUG. 

DISjsn. 

ENABLE,ENGR. 

QDSPLAYjsn. 

SECURES,ot,LA=lowerlevel,UA=upperlevel. 

SECUREQ,est,LA=lowerlevel,UA=upperlevel. 

TIME.hh.mm.ss. 

All memory entry commands. 

All PP breakpoint commands. 

All CPUMTR breakpoint commands. 

In addition, the memory displays are partially disabled on a 
secured system unless the console is in security unlock status. If 
you attempt to display anything outside of the system tables, a 
memory display shows the following message instead of the 
contents of the memory locations. 

****SECURED AREA.**** 
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Memory Entry Commands 

The following commands are used to change the contents of central memory and extended 
memory. Either absolute locations or those relative to a specific job's reference address (RA) 
can be changed. 

CAUTION 

Use these commands with extreme caution to avoid damage to the system or to user jobs. 

Before entering these commands you must unlock the console keyboard (refer to the 
UNLOCK command earlier in this section). On a secured system, the console must be in 
security unlock status. To change central memory, you must bring a central memory 
display (C, D, F, or G) to the left screen. To change extended memory, you must bring the 
M display to the left screen. It is this display that controls whether the memory entry 
commands change absolute memory locations or relative memory locations. 

For example, if you enter 

c, . 

to bring up the C display, any memory entry commands entered make changes to absolute 
memory locations. If you enter 

C , j sn . 

where jsn is a valid job sequence name, any memory entry commands entered make 
changes to memory locations relative to the job's RA. 

Character values or numeric data can replace the current word contents. Either one 12-bit 
byte or a 60-bit word can be changed. A single byte can be changed by inserting the byte 
number after the location; bytes are numbered through 4 from left to right. The address 
and contents are assembled right-justified with zeros filling unused leading positions. 
Leading zeros may be omitted in the entry. 

When you are changing the contents of memory relative to a specific job (a valid job 
sequence name was specified when the memory display was brought to the left screen), the 
negative field length area of the job can be accessed. This area is accessed by specifying a 
negative address in the memory entry command. For example, to change the contents of 
word RA-3, you enter the address 77777775 8 . 

On an unsecured system when you are changing a memory location relative to a specific 
job's RA, the system checks for field length violations. If you specify an address larger than 
your job's RA plus field length, you cannot change its contents. 

On a secured system no memory entry commands are allowed unless the security unlock 
status is set. The memory display shows the message 

****SECURED AREA**** 

instead of the contents of the memory locations to prevent you from examining these 
locations; you may not alter the contents of these locations. When you are displaying 
absolute memory you can see only the system tables. 
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Formats and descriptions for these commands are: 



Command 



Description 



addr,cont. 

or 

addr+cont. 20 

addr,b,cont. 

or 

addr+b,cont. 20 



addr,Dcont. 

or 

addr+Dcont. 20 



Eaddr,cont. 

or 

Eaddr+cont. 20 



Eaddr,b,cont. 

or 

Eaddr+b,cont. 20 



Eaddr,Dcont. 

or 

Eaddr+Dcont. 20 



Changes the contents of central memory location addr (maximum 
of eight digits) to cont (maximum of 20 digits). The second form of 
the command performs essentially the same function but is used 
when it is necessary to change successive memory locations. 

Changes the contents of byte b at central memory location addr 
(maximum of eight digits) to cont. Each location consists of five 
12-bit bytes, numbered through 4 from left to right. The 
contents are four octal characters. The second form of the 
command performs essentially the same function but is used 
when it is necessary to change successive memory locations. 

Changes the contents of central memory location addr (maximum 
of eight digits) to display code characters cont (left-justified and 
zero-filled). Thesecond form of the command performs essentially 
the same function but is used when it is necessary to change 
successive memory locations. 

Changes the contents of extended memory location addr 
(maximum of seven digits) to cont (maximum of 20 digits). The 
second form of the command performs essentially the same 
function but is used when it is necessary to change successive 
extended memory locations. 

Changes the contents of byte b at extended memory location addr 
(maximum of seven digits) to cont. Each location consists of five 
12-bit bytes, numbered through 4 from left to right. The 
contents are four octal characters. The second form of the 
command performs essentially the same function but is used when 
it is necessary to change successive extended memory locations. 

Changes the contents of extended memory location addr 
(maximum of seven digits) to display code characters cont 
(left-justified and zero-filled). The second form of the command 
performs essentially the same function but is used when it is 
necessary to change successive extended memory locations. 



20. If the + sign is specified, the address is incremented by one location (addr+1) after the initial entry is processed; the - sign 
causes the address to be decremented by one location (addr-1). This allows immediate entry for the next (or previous) memory 
location. If the message REPEAT ENTRY is displayed above the entry, the cont field is not cleared and can be entered in 
successive memory locations as many times as desired. 
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Channel Control Commands 

The following commands enable control activity on a specified data channel in 
circumstances where abnormal hardware and/or system operation is detected. Extreme 
caution must be exercised if any of these commands are entered during normal system 
operation. In addition, the console keyboard must be unlocked before entry of any of these 
commands is permitted (refer to the UNLOCK command earlier in this section). DSD does 
not reserve the channel specified in any of the channel control commands. The channels are 
numbered to 13 8 in a 10 PP system and to 13 8 , 20 8 to 33 8 in a 20 PP system. 

CAUTION 

Extreme caution must be exercised when using the following channel control commands. 



Co mman d 



Description 



ACN,cc. 
DCH,cc. 
DCN,cc. 
FCN,cc,func. 

IAN.cc. 
LDC,nnnn. 

MCH,cc. 

OAN,cc. 



Activates channel cc. This command alerts and prepares 
peripheral equipment on channel cc for the exchange of data. 

Drops channel cc. This is a software function to release the 
current reservation of channel cc. 

Deactivates channel cc. As a result, peripheral equipment on 
channel cc stops and any current I/O operation is terminated. 

Outputs a function code func to channel cc. This releases all 
equipment selections on that channel. If func is not specified, a 
zero function code (no activity) is output. 

Inputs data to the pseudo A register from channel cc. 

Loads the pseudo A register with nnnn (normally a peripheral 
equipment function code). The current value of nnnn is shown in 
the channel status display (W,C). 

Master clears and removes all 3000 Computer Systems peripheral 
equipment selections on channel cc (6681 function code 1700 8 is 
issued). 

Outputs the contents of the pseudo A register to channel cc. 
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Extended Memory Flag Register Commands 

The extended memory flag register commands are used to set or clear specific bits in the 
extended memory flag register. These commands are typically used when debugging a 
problem in a multimainframe environment. The console must be unlocked (refer to the 
UNLOCK command earlier in this section). 



CAUTION 



Extreme caution must be exercised when using these commands. 



Command Description 



CFR,bb. Clears the extended memory flag register bit bb (0 < bb < 17). 

SFR,bb. Sets the extended memory flag register bit bb (0 < bb < 17). 

Breakpoint Package Commands 

The breakpoint package consists of a set of DSD commands that controls PP breakpoint 
processing and CPUMTR breakpoint processing. 

PP Breakpoint Commands 

The following DSD commands control PP breakpoint processing. These commands and the 
DSD V display enable you to communicate with the PP breakpoint package. The V display 
is described following the command descriptions. The PP breakpoint commands require that 
the system console be unlocked (refer to the UNLOCK command earlier in this section); on 
a secured system, the console must be in security unlock status. 



CAUTION 



Use these commands with extreme caution to avoid damage to the system or to user jobs. 
Incorrect usage may cause a system to hang up and require a deadstart. 



NOTE 



Breakpoint can be set for only one PP program at a time. Before setting breakpoint for 
another program, it must be cleared on the first program. 
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Command Description 



BKP. Clears an existing PP breakpoint. 

BKP,prog,cp. Sets breakpoint for PP program prog at control point cp. The 

control point parameter cp is optional. The PP program prog can 
be any PP program or overlay except the following: 

• PPR overlays (1DD, OSE, etc.). 

• Mass storage drivers. 

• Mass storage error processors. 

• Any PP program that overwrites PP memory greater than 
7500 8 with instructions or data. The breakpoint program 
uses PP memory locations 7500 8 to 7777 8 . If the PP program 
is allowed to modify those locations on load, execution, or 
overlay load, unpredictable results may occur. Refer to the 
PP breakpoint precautions in the following section. 

• Concurrent (16-bit) PP programs. 

The PP program need not be a main program, and it can reside in 
central memory, disk, or extended memory (ECS/ESM/UEM). 

PPnn.A,val. Sets the A register to the value val for PP number nn. Up to 18 

bits can be specified for the value parameter val. 

PPnn.C,addr. Causes the V display for PP number nn to display 100 8 bytes of 

PP memory, starting at base address addr, as the C block. 

PPnn.C,addr,val. Changes the contents of PP memory word addr for PP number nn 

to value val. The specified address must point to one of the PP 
memory words displayed in the C block of the V display. 

PPnn.D,addr. Causes the V display for PP number nn to display 100 8 bytes of 

PP memory, starting at base address addr, as the D block. 

PPnn.D,addr,val. Changes the contents of PP memory word addr for PP number nn 

to value val. The specified address must point to one of the PP 
memory words displayed in the D block of the V display. 

PPnn.EXR. Resumes execution in PP number nn with a breakpoint set in the 

PP-resident subroutine EXR (after the next overlay load 
completes, but before execution of the overlay begins). 

PPnn.FTN. Resumes execution in PP number nn with a breakpoint set in the 

PP-resident subroutine FTN+1 (to trap the next monitor function 
before it is issued to MTR/CPUMTR). 
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Command 



Description 



PPnn.G. 
PPnn.G,addr. 

PPnn.P,addr. 
PPnn.S. 



PPnn.SX. 



V,nn. 

V,HNG. 

V,PS. 



Resumes normal PP program execution for PP number nn with no 
breakpoint set. 

Resumes PP program execution for PP number nn with a 
breakpoint set at address addr. The address addr must be within 
executable code and lie on a PP instruction boundary, but the 
validity of the address is not checked. 

Resets the P register to address addr for PP number nn. When 
the PP program resumes execution, it will start at P=addr. 

Steps the PP program one instruction for PP number nn. Indexed 
jump instructions, channel jump instructions, and instructions 
that jump to the current program address or current program 
address minus one cannot be stepped. If you try to step these 
instructions, the following message appears on the system console: 

CAN-T STEP. 

Steps the PP program one instruction for PP number nn. This 
command performs the same function as the PPnn.S. command 
except that if an RJM instruction is encountered, a breakpoint is 
set to the instruction after the RJM and the entire subroutine is 
executed. 

Brings up the DSD V display for PP number nn. 

Brings up the DSD V display for a hung PP. 

Brings up the DSD V display for the pseudo PP. 



V Display 

The DSD V display complements the PP breakpoint commands to provide an analyst's tool 
for PP breakpoint processing. The information displayed is for the PP number specified in 
the V,nn command. Figure 5-4 shows the format of the V display. The display shows the PP 
communications area for the specified PP (10 8 CM words), the contents of the P and A 
registers, and two 100 8 word blocks of PP memory (C and D). The base addresses of the C 
and D blocks are set by PPnn.C,addr and PPnn.D,addr commands. 

If the specified PP is not at breakpoint when the V display is brought up, the display shows 
only the communications area and the following message: 

NOT AT BREAK. 
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V,nn. PP BREAKPOINT. 
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Figure 5-4. PP Breakpoint V Display 
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PP Breakpoint Precautions 

The following precautions and information are important to the successful use of the PP 
breakpoint package. 

• The breakpoint must be set in executable code and must he on a PP instruction 
boundary. 

• When a breakpoint is set, two words of PP memory are replaced with the following: 

RJM BKP 

When the breakpoint is hit, the two replaced words are immediately restored. However, 
16-bit instructions are not restored properly since they revert to 12-bit instructions. 

• The PP breakpoint package uses PP locations 7500 8 through 7777 8 . If these locations 
are altered by the running PP, the system will probably fail. 

• If the PP program being breakpointed encounters a mass storage error, the mass 
storage driver's error processor will overlay the PP breakpoint code, and will probably 
crash the operating system. 

• If the PP program being breakpointed performs code modification on the instruction at 
the address at which the breakpoint has been set, unpredictable results may occur. 

• The PP breakpoint package cannot be used on DIS or 026. However, it can be used on 
other PPs at the same control point as DIS or 026. 

• The PP breakpoint information (BKP,prog) remains set until BKP is entered or a 
SYSEDIT or any level of deadstart is performed. 
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CPUMTR Breakpoint Commands 

The following DSD commands control CPUMTR breakpoint processing. These commands 
and the DSD C display enable you to communicate with the CPUMTR breakpoint package. 
The C display is described following the command descriptions. The CPUMTR breakpoint 
commands require that the system console be unlocked (refer to the UNLOCK command 
earlier in this section); on a secured system, the console must be in security unlock status. 

CAUTION 

Use these commands with extreme caution to avoid damage to the system or to user jobs. 
Incorrect usage may cause a system to hang up and require a deadstart. 



NOTE 

Only one CPUMTR breakpoint can be set at a time. Any existing breakpoint is cleared 
when you enter a CPB,BKP,... command. 



Command 



Description 



CPB,BKP,addr. 
CPB,BKP//addr. 
CPB,BKP,/bbbb/addr. 
CPB,DSP. 

CPB,DSP,addr. 

CPB,DSP//addr. 

CPB,DSPybbbb/addr. 

CPB,DSP+ 
CPB,DSP- 



Sets breakpoint at absolute address addr. Restarts execution, if 
the CPU is waiting for a GO. 

Sets breakpoint at CPUMTR relative address addr. Restarts 
execution, if the CPU is waiting for a GO. 

Sets breakpoint at address addr in CPUMTR block bbbb. Restarts 
execution, if the CPU is waiting for a GO. 

Brings up the CPUMTR breakpoint variant of the C display on 
the left screen if the C display is not already active. Causes the 
memory block in the C display to begin at the breakpoint address. 

Brings up the CPUMTR breakpoint variant of the C display on 
the left screen if the C display is not already active. Causes the 
memory block in the C display to begin at absolute address addr. 

Brings up the CPUMTR breakpoint variant of the C display on 
the left screen if the C display is not already active. Causes the 
memory block in the C display to begin at CPUMTR relative 
address addr. 

Brings up the CPUMTR breakpoint variant of the C display on 
the left screen if the C display is not already active. Causes the 
memory block in the C display to begin at address addr in 
CPUMTR block bbbb. 

Brings up the CPUMTR breakpoint variant of the C display on 
the left screen if the C display is not already active. Advances 
each of the memory block addresses by 10 8 . 

Brings up the CPUMTR breakpoint variant of the C display on 
the left screen if the C display is not already active. Decrements 
each of the memory block addresses by 10 8 . 
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Command Description 



CPB,GO. Clears any breakpoint that is set and allows CPUMTR to restore 

its registers and continue execution. 

CPB,P+ Sets breakpoint at the address following the current breakpoint 

address and restarts execution, if the CPU is waiting for a GO. 

CPB,P- Sets breakpoint at the address preceding the current breakpoint 

address and restarts execution, if the CPU is waiting for a GO. 



CPUMTR Breakpoint Display (C Display) 

The CPUMTR breakpoint display is a variant of the DSD C display that is formatted for use 
in CPUMTR breakpoint processing. This display is initiated by entering one of the CPB,DSP 
commands. Figure 5-5 shows the format of the CPUMTR breakpoint display. The display 
consists of the 20 8 -word exchange package from the current or last breakpoint (displayed in 
5 groups of 4 octal digits per line). All exchange package information is displayed except 
RA, FL, RAE, FLE, and MA. The P address shown is the actual breakpoint address. 

The exchange package is followed by two 10 8 -word blocks of central memory (displayed in 4 
groups of 5 octal digits per line). The address of the memory block to be displayed can be 
specified using one of the CPB,DSP commands. Even if the address specified in the 
CPB,DSP command is a relative address, the addresses shown in the display are absolute; 
thus, giving the actual location in memory of the displayed data. 
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C. CENTRAL MEMORY. 
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Figure 5-5. CPUMTR Breakpoint Display 
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CPUMTR Breakpoint Precautions 

The following precautions and information are important to the successful use of the 
CPUMTR breakpoint package. 

• The breakpoint must be set in executable code. 

• When a breakpoint is set, DSD stores RJ BKP at the specified address. When the 
breakpoint address is hit, CPUMTR saves all of the registers in the display area, clears 
the breakpoint, and then waits to receive a GO. The message CPUMTR BREAKPOINT 
HIT is displayed at the system control point. 

• From the time that the breakpoint is bit until the CPU continues, the system clock 
stops. Therefore, you should reset the system clock (with the DSD TIME command) 
after you have finished breakpoint processing. 

• A CPUMTR breakpoint can be set in monitor mode or program mode. However, 
alternating between the modes is not advised. Going from monitor to program mode is 
probably safe, but going from program to monitor mode is almost certain to fail causing 
CPUMTR to abort with the following message issued to the system console: 

CPUMTR ERROR EXIT. 

• Since the C display is resident in RPL, changing displays is allowed (before the 
breakpoint is hit) because you can always return to the C display. However, once the 
breakpoint is hit until the CPU continues, CPUMTR is hung. This means that all 
activity in the system stops until the CPU restarts. If DSD attempts to request a 
monitor function, the following message appears in the B display: 

NO MONITOR RESPONSE. 

This is normal since CPUMTR is hung in the breakpoint code and the message may be 
ignored. In this case, the DSD request that required the monitor function is not 
processed. 

• If you attempt to reference a CPUMTR block that is not loaded, the following message 
appears on the system console: 

INCORRECT ENTRY. 

• The C display retains the last addresses displayed. For example, if you change to 
another display and then come back to the C display it will still show the same absolute 
addresses. 

• Once a breakpoint has been hit and CPUMTR is waiting for a CPB,GO (or another 
CPB,BKP) command, the contents of any register or memory location can be changed by 
using the normal memory entry commands. To change a register, simply change the 
corresponding memory location on the C display (as initiated by the CPB,DSP 
command). The exchange package shown on the C display will be reloaded to display 
the actual registers when execution resumes. 



NOTE 



Since CPUMTR has been halted, any memory entries made at this time must be 
preceded by a 99 command to disable DSD syntax overlay processing and the logging of 
the command to the error log. 
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Debugging Commands 

The following commands trap certain conditions and at the same time trace selected PP and 
MTR to CPUMTR functions. 

TRACE 

TRAP 

These debugging commands can be used to solve specific system problems. Care must be 
exercised in using the commands in a production environment as performance may be 
impacted significantly. 

The following entry must be made in the IPRDECK at deadstart. 

ENABLE, TRACE. 

In addition, system debug mode must be enabled at the system console (the console must be 
unlocked to do this) in order to execute the TRAP and TRACE commands. 



Command 



Description 



TRACE,type, 
parameters. 



Permits specification of monitor functions and other system data. 
Entering the command without any parameters (TRACE,PPU. or 
TRACE,MTR.) clears the trace function. The following types may 
be traced. 



type 



PPU 



Description 



Traces PP to CPUMTR requests. Each trace buffer 
entry consists of the following words: 

Time stamp. 

PP input register. 

PP output register. 

PP message buffer (6 words). 

Absolute address 1 (default is SMRL). 

Absolute address 2 (default is CMCL). 

The format of the time stamp word is: 

***dhmslll 

In this format, dhms is bits 23-0 (day, hour, 
minute, and second) of PDTL and 111 is bits 17-0 of 
RTCL. 

The trace buffer can hold 20 entries. The oldest 
entry in the buffer is overwritten by a new entry 
once the buffer is filled. The DSDI directive 
TBDUMP,PPU displays the buffer, as well as the 
functions traced, the absolute addresses saved, and 
the buffer IN pointer. 
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Command 


Description 




TRACE,type, 
parameters. 


(Continued) 
type 


Description 




MTR 


Traces MTR to CPUMTR functions. Each trace 
buffer entry consists of the following words: 

• Time stamp. 

• Function. 

• Absolute address 1 (default is SMRL). 

• Absolute address 2 (default is CMCL). 

• *MCT* 



SET,ABS 
SET,CPA 



*MCT* expands to the following for each entry in 
the memory control table (MCT): 

MCT word 1. 

MCT word 2. 

CPA/PCPA address 1 (default is STSW). 

CPA/PCPA address 2 (default is FLSW). 

Word TFSW from the CPA/PCPA. 

Word JSNE from the EJT. 

Depending on the number of pseudo-control points 
defined, there is room for approximately 10 entries 
in the trace buffer. The oldest entry in the buffer is 
overwritten by a new entry once the buffer is filled. 

The DSDI directive TBDUMP,MTR displays the 
buffer, as well as the functions traced, the absolute 
and CPA/PCPA addresses saved, and the buffer IN 
pointer. 

Sets the absolute addresses of the CM words to be 
saved in the trace buffer entry. 

Sets the CPA/PCPA addresses of the CM words to 
be saved in the trace buffer entry. 
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Command 



Description 



TRACE,type, 
parameters. 



(Continued) 

The following parameters are used with TRACE.MTR and 
TRACE,PPU. Trace data is collected by CPUMTR immediately 
before the selected function is processed. 

parameters Description 

* Traces all functions of the selected type. 

Fj ^2,— ^3 Traces up to five functions. Functions are specified 
by their symbolic names. 

The following parameters are used with TRACE,SET,ABS and 
TRACE,SET,CPA 

parameters Description 

addr 1 ,addr 2 Sets the absolute (TRACE 7 SET,ABS) or relative 
(TRACE,SET,CPA) addresses of the words to be 
saved in each trace buffer entry. The addresses 
must be octal digits. 

The following examples illustrate various forms of the TRACE 
command. 



Example 



TRACE , PPU , ROCM , JACM . 



TRACE, MTR,ACSF. 



TRACE, SET, ABS, 21 , 152 . 



TRACE, SET, CPA, 21,57. 



Description 



Causes a trace entry to be 

created each time a JACM or 

ROCM monitor function is 

issued. 

Causes a trace entry to be 

created each time an ACSF 

function is issued. 

Causes words 21 8 and 152 8 to be 

saved in each trace buffer entry. 

Causes words 21 8 and 57 8 of 
each CPA and PCPA to be saved 
for each MTR trace buffer entry. 
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Command 



Description 



TRAP.type, 
parameters. 



Halts the system immediately (in monitor mode) upon detection 
of a specified condition. Only one type of trap can be active at 
once. Entering the command without any parameters (TRAP.) 
clears the trap. 



The following types do not accept parameters: 
type Description 



NFL 

MCT 

EJT 
DJB 



Checks for erroneous data in negative field length 
of executing jobs. 

Checks for invalid data in the memory control 

table. 

Checks for invalid data in the executing job table. 

Checks for jobs that are no longer executing, but 
are failing to advance. 



The following types accept parameters: 
type Description 



CPA 
MEM 



Checks a specified control point area field or 
pseudo-control point area field for a given value. 

Checks a field specified by an absolute address 
(central memory only) for a given value. 



The following parameters, which are associated with CPA and 
MEM, indicate the field and value being checked: 

parameters Description _^ 



W 
V 
H 
L 



Absolute address (type=MEM) or offset 
(type=CPA). 

Value (octal). If V=N, any nonzero field value halts 
the system. 

Left-most bit of field. Decimal value ranges from 

to 59.8 

Right-most bit of field. Decimal value ranges from 

0to59. 



The following examples illustrate various forms of the TRAP 
command: 

Example Description 

trap, cpa, 20,n,47 , 36 . Checks for any nonzero value in 

bits 47 to 36 of word 20 in each 
control point area. 

trap, mem, 37461,36,7,3 Checks for a value of 36 in bits 7 

to 3 of 37461. 
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Express Deadstart Dump Interpreter 

(DSDI) 6 

Calling the Express Deadstart Dump Interpreter 6-3 

Input Directives 6-6 

Directive Format 6-7 

List Control Directives 6-8 

EJ — Force Page Eject 6-8 

EJOFF — Turn Off Auto Page Eject 6-8 

EJON — Turn On Auto Page Eject 6-8 

PD — Reset Print Line Density 6-8 

*. — Comment in Subtitle Line 6-9 

File Manipulation and Control Directives 6-9 

DISPOSE — Dispose Alternate List File to Print Queue 6-9 

OUTPUT — Assign Output to Alternate List File 6-9 

READ — Read Alternate Directives File 6-10 

REWIND — Rewind File 6-10 

Central Memory/Extended Memory Dump Directives 6-11 

Dump Control Directives 6-11 
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Express Deadstart Dump Interpreter 

(DSDI) 6 

The deadstart dump interpreter (DSDI) is a utility program that converts selected portions 
of the binary information on an express deadstart dump (EDD) file into reports to be listed. 
The EDD file is generated on magnetic tape by the EDD utility, which may be run at 
deadstart time after a system malfunction has occurred. Refer to the CIP User's Handbook 
for complete information concerning the use of EDD. 

Selection of data to be listed by DSDI is provided through input directives, either on an 
input file or on the DSDI command. Normal octal dumps of central memory, extended 
memory, and PP memory can be produced by these directives as well as specially formatted 
dumps of specific system tables and buffers. 

EDD and DSDI offer these features: 

• The EDD tape file contains a dump of memory, the executing exchange packages, the 
CYBER 170 status and control (S/C) registers, where applicable; maintenance registers 
for models 865 and 875 and CYBER 180-class machines, register file, exchange package, 
processor control store, processor operand cache, processor page map, processor segment 
map, where applicable; and all PPs except for PPO, which can be saved by either 
copying it to another PP or by biasing the PP switch on the deadstart panel. EDD can 
optionally dump all or part of extended memory and the selected buffer controllers. 
EDD and DSDI permit analysis of a system malfunction to be performed entirely offline. 

• Because DSDI copies the EDD file to a word-addressable random file on mass storage, 
dump data can be accessed in any order. 

• EDD requires only a small amount of time during deadstart because the data is 
transferred in binary form to magnetic tape. 

• The tape file created by EDD can be retained on magnetic tape or mass storage until it 
is no longer needed. Thus, a selective listing can be generated at any time. 

• General information from the EDD file appears in the title and subtitle line of each 
page of listed output. The first 50 columns of each input directive are included in the 
title line of the output fist it produces. An input directive is provided that enables 
insertion of comments into the subtitle line. 

• Use of DSDI is possible from an interactive terminal as well as from the batch 
environment. The output produced by several directives is formatted for terminal output 
(72 columns). From a batch environment, output is formatted for a 136-column printer. 
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DSDI can also be used to create a message file containing the contents of the maintenance 
registers (input/output unit, memory, and processor) that were dumped to the EDD file for 
CYBEE 180-class machines. This message file, which is similar in format to the binary 
maintenance log (BML), can then be analyzed by an interpreter program, such as the 
Hardware Performance Analyzer (HPA), to produce maintenance register reports. Refer to 
the IOUMR, MEMMR, and PROMR DSDI input directives later in this section for 
additional information. 

DSDI writes up to three messages to this message file: one message each for input/output 
unit errors, memory errors, and processor errors. If the status summary register for a 
particular element is zero (signifying no errors for that element), DSDI does not write the 
corresponding message to the message file. 

In addition, the message file contains messages for any errors that were detected by the 
dedicated fault tolerance (DFT) processor but not yet written to the BML at the time the 
EDD file was created. These messages are identical in format to the ones that would have 
been written to the BML by the normal logging process. 
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Calling the Express Deadstart Dump Interpreter 

Processing of the EDD file is initiated with the DSDI command. The format of the command 



is: 



DSDI,p 1 ,p 2 , P n - 

Each parameter p t is either a keyword or a keyword equated to a value. All parameters are 
optional and order independent. 



Pi 



B=bmlfile 



B omitted 
D=fn 



D 

D omitted 
DMB 

DMB omitted 



Description 



The 1- to 7-character name of the message file on which the 
maintenance register messages and unlogged DFT error messages 
are to be written. The message file is similar in format to the BML 
and can be analyzed by HPA. This parameter is valid only if 
maintenance register messages or unlogged DPT error messages 
have been dumped to the EDD file. 

No message file is to be created. 

This parameter causes DSDI to write the random dump file to file 
fn. The original EDD file is not returned. The random file can then 
be used as the dump file on subsequent executions of DSDI, 
eliminating the need to read the entire dump tape on each call. This 
allows file fn to be predefined as a permanent mass storage file. 

Creates a random dump file with the same name as the EDD file 
and returns the original EDD file. 

No random dump file is to be created. 

A binary dump file produced by the DMB or LOADBC command is 
to be analyzed instead of an EDD file. 

EDD file is to be analyzed. 

When the DMB parameter is specified for a DMB-created dump, 
DSDI uses directives as though the job were running at control 
point 1. The DMB command dumps the exchange package, central 
memory, and extended memory in binary (refer to the NOS Version 
2 Reference Set, Volume 3). Use the following directives to dump 
selected portions of memory to be analyzed. 



Directive 



Description 



CP,1 

BAC,1/C,fwa,lwa 

RAC,1/D,fwa,lwa 

RA,0/EC/C,fwa,lwa 

RA,0/EC/D,fwa,lwa 



Dump exchange package. 
Dump central memory in C format. 
Dump central memory in D format. 
Dump extended memory in C format. 
Dump extended memory in D format. 
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Calling the Express Deadstart Dump Interpreter 



Pi 



Description 



DMB omitted 



F=dumpfile 
F omitted 
FULL 
FULL omitted 



I=infile 

I omitted 
L=outfile 

L omitted 

NR 

NR omitted 

P 



P omitted 
PD=n 



(Continued) 

fwa and lwa are the first and last word addresses of memory to be 
dumped. When this parameter is specified to analyze a LOADBC 
controlware dump, the only DSDI directive that can be used is: 

BCDUMP/ops. 

Refer to the BCDUMP directive described later in this section for a 
description of the ops parameter. 

The 1- to 7-character name of the EDD file that DSDI will interpret. 

Same as F=DUMP. 

Entire EDD file is read. 

When interpreting a dump for a CYBER 180-class system, the EDD 
file is read only up to the end of NOS memory. NOS/VE memory, 
external extended memory (STORNET or ESM) and buffer 
controller records are not read. 

The 1- to 7-character name of file on which input directives are 
written. 

Same as I=INPUT. 

The 1- to 7-character name of file on which fist output is to be 
written. The user must save or print the file. 

Same as L=OUTPUT, except that the file is automatically printed. 

EDD file is not to be rewound. 

EDD file is to be rewound before processing. 

CMR pointers from the running system are to be used. Selecting 
this parameter causes the CMR pointers from the running system 
to be used to locate tables and buffer areas on the EDD file. This 
parameter is typically used when it is known that the CMR pointers 
on the EDD file were destroyed by system malfunction. Directives 
used to dump CMR will dump the pointers contained on the EDD 
file, not those from the running system. 

This parameter should be used only when the configuration of the 
running system is the same as the system in use when the EDD file 
was created. 

CMR pointers from EDD file are to be used. 

Print density in number of lpi (3, 4, 6, or 8). 
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Calling the Express Deadstart Dump Interpreter 



Pi 



Description 



PD 

PD omitted 

Z 



Z omitted 



Same as PD=8. 

Same as the job's default print density. 

Input directives are contained on the command after the 
terminator. The I parameter is ignored. This eliminates the need to 
use a separate input file for the directives when only a few 
directives are needed. 

Input directives are not contained on the command. The system 
uses the I parameter. 

When input directives appear on the DSDI command, the first 
character following the command terminator is the separator 
character for all directives on the command. Any display code 
character that is not used in any of the directives, including a space, 
can be used as the separator character. Each directive must be 
preceded by a separator and terminated by a period. The directives 
can extend to column 72 on the command. Continuation lines are 
not permitted. 

For example, (slant used for separator): 

DSDI, Z. /SC./XP. /P. /D, 0,20000. /EC. /D, 0,10000. 

If the directives are included in the input file, the following 
equivalent job would appear. 



DSDI. 
--EOR-- 

SC. 

XP. 

P. 

D, 0,20000. 

EC. 

D, 0,10000. 

--EOI-- 



Dump CYBER 170 S/C register. 

Dump executing exchange packages. 

Dump all PPs. 

Dump the first 20000 8 locations of central memory. 

Set memory type to extended memory. 

Dump the first 10000 8 locations of extended memory. 



A request for the EDD tape must precede the DSDI command. Since EDD writes 
information on a labeled, 7- or 9-track tape at a density of 800 characters per inch (cpi) for 7 
track and 1600 or 6250 cpi for 9 track, the request should appear as follows: 

LABEL , DUMP , D=density , tape , F=S , LB=KL , VSN=DUMP . 



Parameter 



Description 



density 
tape 



800 cpi for 7-track tape. 

1600(PE) or 6250(GE) cpi for 9-track tape. 

MT for 7-track tape. 
NT for 9-track tape. 
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Input Directives 



The request is presented in the resource mounting preview display and the job is rolled out 
until the tape is mounted and assigned. Although the default express dump file name 
(DUMP) is used in this example, a different file name can be specified, provided the same 
file name is also specified on the DSDI command (F parameter). 

Input Directives 

DSDI input directives provide the capability to selectively dump only those portions of the 
EDD file that are of interest. The input directives are grouped into the following categories. 



Type of Directive 

List control 



Description 



File manipulation and control 

Central memory/extended 
memory dump 



PPdump 



Enables you to control line printer page eject and print 
density, and to specify comments in subtitle line of the 
output fisting. 

Enables you to specify alternate files for DSDI input 
directives and listing output. 

Provides octal dumps of specified portion of central 
memory or extended memory. Absolute or relative 
addresses can be printed (three print formats are 
available). Two additional dump formats are available to 
print 64-bit memory in hexadecimal for CYBER 180-class 
machines. 

Provides octal memory dumps of all or selected PPs (two 
print formats are available). PP analysis data can be 
included in the dumps. Six additional formats are 
available to print 16-bit PP memory for CYBER 
180-class machines. 

Provides specially formatted dumps of selected areas in 
central memory resident. These areas are specified by 
name rather than by address. 

Provides specially formatted dumps of subsystem control 
points and associated tables and buffers. 

Hardware register dump Provides dumps of specified hardware registers. 

Several of the DSDI input directives have interactive capabilities. The output produced by 
these directives is specially formatted for listing at an interactive terminal. Refer to 
Interactive Use of DSDI later in this section for information concerning directive entry and 
use of DSDI from an interactive terminal. 

Refer to Printer Output Listing Examples, later in this section, for examples of listings 
produced by several of the DSDI input directives. 



CMRdump 



Subsystem dump/analysis 
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Directive Format 

A directive has the following format. 

directive, p 1 ,p 2 . • • • ,p n . comments 



Field 



Description 



directive The directive name starts in column 1. It is terminated by a separator or 
terminator character. 

p. Parameter(s) for the directive. Depending on the requirements of the 

directive, the directive may have no parameters or a number of parameters. 

comment Any characters following the directive terminator are considered comments 
and are ignored by DSDI. However, the comments are included with the 
directive in the title line of each page of the output listing (a combined total 
of 50 characters appear in the title line). 

separator You can use any character, including a space, to separate the fields of a 
directive. The exceptions are: 

AtoZ 
0to9 



Refer to Interactive Use of DSDI later in this section for additional information concerning 
directive entry from an interactive terminal. 
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List Control Directives 

The list control directives provide the capability to specify print density and page eject 
options, and to add comments in the subtitle line of each page listed. 

E J — Force Page Eject 

The EJ directive forces to issue a page eject function before listing the output produced by 
the next directive processed. The EJ directive can also force a page eject upon reaching a 
specified point on the page being printed. The page eject function is performed 
automatically unless disabled by the EJOFF directive. 

Format: 

EJ,nn. 

Parameter Description 

nn Force page eject only if less than nn decimal lines remain on the current 

page. If nn is omitted, page eject is forced before listing the output from the 
next directive processed. 



EJOFF — Turn Off Auto Page Eject 

The EJOFF directive disables auto page eject. Until this directive is processed, DSDI 
automatically issues a page eject function before listing the output produced by each new 
directive. 

Format: 

EJOFF . 

EJON — Turn On Auto Page Eject 

The EJON directive enables auto page eject (default condition). DSDI automatically issues a 
page eject function before listing the output produced by each new directive processed. This 
directive has no effect unless auto page eject has been disabled by the EJOFF directive. 

Format: 

EJON. 

PD — Reset Print Line Density 

The PD directive resets the print line density to a value other than that specified on the 
DSDI command. 

Format: 

PD,n. 

Parameter Description 

n New print line density in number of lpi (3, 4, 6, or 8). If n is omitted or an 

incorrect value is specified, a diagnostic message is issued. 
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Input Directives 

*. — Comment in Subtitle Line 

The *. directive specifies a comment that appears in the subtitle line of each page listed. 
Format: 

* .ccc . . .ccc 



Parameter Description 

ccc... ccc Comment; up to 36 characters are printed. 



File Manipulation and Control Directives 

File manipulation and control directives provide the capability to specify alternate files for 
DSDI input directives and listing output. 

DISPOSE — Dispose Alternate List File to Print Queue 

The DISPOSE directive causes the alternate list file specified by the OUTPUT directive to 
be disposed to the print queue. DSDI listing output then resumes on the original output 
file. This directive has no effect unless output has previously been assigned to an alternate 
fist file (refer to the OUTPUT directive, next). Refer to Interactive Use of DSDI later in this 
section for additional information concerning use of this directive from an interactive 
terminal. 

Format: 

DISPOSE , username . 

Parameter Description 



username User name under which the remote batch terminal to receive the listing is 
logged in. If username is omitted, the listing is printed at a central site line 
printer. 



OUTPUT — Assign Output to Alternate List File 

The OUTPUT directive temporarily assigns DSDI listing output to a file other than that 
specified on the DSDI command. When the alternate file is disposed to the print queue 
(refer to the DISPOSE directive, above), output resumes on the original output file. If the 
alternate file is not disposed, both the original and the alternate output files remain at the 
job control point as local files. Refer to Interactive Use of DSDI later in this section for 
additional information concerning use of this directive from an interactive terminal. 

Format: 

OUTPUT , f i 1 ename . 



Parameter Description 



filename Name of alternate fist file (from 1 to 7 characters). Only one alternate output 
file may be active at a time; filename cannot be the same name as the normal 
output file. If filename is omitted, the system assumes file name ALTRNT. 
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READ — Read Alternate Directives File 

The READ directive causes DSDI to temporarily stop reading the current directives file and 
begin reading directives from the specified record on the named alternate file or from the 
current position if the record name is omitted. DSDI reads from the specified alternate 
directives file until an end-of-record is encountered (end-of-file or empty record if * is 
specified) and then resumes with the next directive on the original input directives file. 

Format: 

READ, filename, rec, * . 

Parameter Description 

filename Name of alternate directives file (local file). 

rec Optional record name. If rec is specified, file filename is searched for record 

rec from the current position to end-of-file or an empty record. If rec is not 
found, DSDI issues an error message. If rec is not specified, DSDI reads 
directives from the current position to end-of-record. Records must be in text 
format where the first word of the record is the record name, unless the file is 
assigned to an interactive terminal; then, directives may be entered directly. 

* Optional character specifying that DSDI is to read directives from all records 

until an end-of-file or an empty record is encountered. 



REWIND — Rewind File 

The REWIND directive repositions the specified file to beginning-of-information. 
Format: 

REWIND, filename. 

Parameter Description 

filename Name of file to be rewound. 
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Input Directives 

Central Memory/Extended Memory Dump Directives 

The central memory/extended memory dump directives provide the capability to dump any 
portion of central memory or extended memory in instruction parcel, byte, or word format. 
There are 6-bit display code character equivalents included with each format. Either 
absolute or relative memory locations may be dumped. Refer to CMR Dump Directives later 
in this section for directives used to dump specific portions of NOS central memory resident 
(CMR). 

Dump Control Directives 

Dump control directives select the type of memory to be dumped (central memory or 
extended memory) and the addressing mode to be used (absolute or relative). 

ALLMEM — Extend Central Memory Dumps 

The ALLMEM directive enables central memory dumps to extend past the central memory 
boundary on machines with central memory extension. 

Format: 

ALLMEM. 

CM — Set Memory Type to Central Memory 

The CM directive specifies that subsequent C, D, and E directives dump central memory 
locations. Unless the EC or UEC directive is specified, central memory locations are 
dumped by default. 

Format: 

CM. 
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EC — Set Memory Type to Extended Memory 

The EC directive specifies that subsequent C, D, and E directives dump extended memory 
or unified extended memory (UEM) locations. Unless the EC or UEC directive is specified, 
central memory locations are dumped by default. 

Format: 

EC , emid . 

or 

EC, emid, fwa. 

Parameter Description 

emid Extended memory identification; emid can be UEM or ESM. If emid is 

omitted, UEM is assumed. This parameter is useful only on models 865, 875, 
and CYBEE 180-class machines since all other models have only one type of 
extended memory available. 

NOTE 

If ESM is specified when interpreting a dump of a CYBER 180-class 
machine, the FULL option must be specified on the DSDI command. 

fwa First word address (fwa) divided by 1000 8 . fwa is added to the fwa and last 

word address (lwa) parameters in subsequent C, D, and E directives when 
dumping UEM. If fwa is omitted, DSDI determines the beginning of unified 
extended memory from the pointer in CMR and adds it to the fwa and lwa 
parameters of the C, D, and E directives. 

This parameter is ignored on any machine other than models 865 and 875 
and CYBEE 180-class machines. 



RA — Reset Reference Address 

The RA directive specifies that subsequent C, D, and E directives dump memory locations 
relative to a specified reference address. Unless the RA or RAC directive is entered, 
absolute memory locations are dumped by default. 

Format: 

RA.nnnnnnn. 

Parameter Description 

nnnnnnn Reference address; addresses specified on subsequent C, D, and E directives 
are relative to this address. 

Clearing the reference address specified on the most recent RA or RAC directive reenables 
absolute addressing. This is done by entering the RA directive in this format: 

RA,0. 



6-12 NOS Version 2 Analysis Handbook 60459300 U 



Input Directives 



RAC — Reset Reference Address to RA of Control Point 

The RAC directive specifies that subsequent C, D, and E directives dump memory locations 
relative to the reference address of a specified control point. Unless the RA or RAC directive 
is entered, absolute memory locations are dumped by default. 

Format: 

RAC,nn. 

Parameter Description 



nn Control point number; addresses specified on subsequent C, D, and E 

directives are relative to the reference address of this control point. 

Refer to the description of the RA directive to reenable absolute addressing. 

UEC — Set Memory Type to User-Access Extended Memory 

The UEC directive specifies that subsequent C, D, and E directives dump user-accessible 
extended memory locations. Unless the EC or UEC directive is specified, central memory 
locations are dumped by default. 

Format: 

UECfwa. 

Parameter Description ^ 



fwa First word address divided by 1000 8 for user-accessible extended memory, 

fwa is added to the fwa and lwa parameters in subsequent C, D, and E 
directives. If fwa is omitted, DSDI determines the beginning of 
user-accessible extended memory from the pointer in CMR and adds it to the 
fwa and lwa parameters of the C, D, and E directives. 
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Memory Dump Directives 

Memory dump directives specify the area of memory to be dumped and determine the format 
of the output listing (refer to Printer Output Listing Examples later in this section for a 
sample output listing). The CM and EC or UEC directives determine the type of memory to 
be dumped (default is central memory). Absolute memory locations are dumped unless 
relative addressing has been enabled (refer to RA and RAC directives earlier in this section). 

C — Dump Memory in Instruction Parcel Format 

The C directive causes the specified locations of central memory or extended memory to be 
dumped in four groups of five octal digits (three words per line) with 6-bit display code 
character equivalents. Repetitive data is suppressed. 

Format: 

C, fwa, lwa. 

Parameter Description 

fwa First word address to be dumped (mandatory). 

lwa Last word address, plus one location, to be dumped. If lwa is omitted, fwa+1 

is assumed by default. 

The output listing is read from top to bottom by column rather than across the page. Refer 
to Interactive Use of DSDI later in this section for additional information concerning use of 
this directive from an interactive terminal. 

D — Dump Memory in Byte Format 

The D directive causes the specified locations of central memory or extended memory to be 
dumped in five groups of four octal digits (three words per line) with 6-bit display code 
character equivalents. Repetitive data is suppressed. 

Format: 

D , fwa , lwa . 

Parameter Description 

fwa First word address to be dumped (mandatory). 

lwa Last word address, plus one location, to be dumped. If lwa is omitted, fwa+1 

is assumed by default. 

The output fisting is read from top to bottom by column rather than across the page. Refer 
to Interactive Use of DSDI later in this section for additional information concerning use of 
this directive from an interactive terminal. 
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E — Dump Memory in Word Format 

The E directive causes the specified locations in central memory or extended memory to be 
dumped in word format (four words per line) with 6-bit display code character equivalents. 

Format: 

E , f wa , lwa . 

Parameter Description 

fwa First word address to be dumped (mandatory). 

lwa Last word address, plus one location, to be dumped. If lwa is omitted, fwa+1 

is assumed by default. 



J — Dump 64-Bit Memory in Instruction Parcel Format 

The I directive is valid on CYBER 180-class machines only. It prints the specified locations 
of central memory in four groups of four hexadecimal digits (three words per line) with 7-bit 
ASCII code character equivalents. The second format is for NOS/VE dumps. 

Format: 

I,fba,lba,ei. 

or 

I, fba,lba,asid. 

Parameter Description 



fba First byte address (fba), hexadecimal, to be printed (mandatory). 

lba Last byte address (lba), plus one location, to be printed. If lba is omitted, 

fba+8 is assumed by default. 

ei If ei is 1, fba and lba specify byte addresses relative to byte of the 

environment interface. If ei is omitted, fba and lba specify absolute byte 
addresses. 

asid Specifies an actual segment identifier (ASID) for NOS/VE dumps. If you 

specify this parameter, the fba and lba parameters must represent byte 
offsets and have values in the range of from to 7FFFFFFF hexadecimal. 
This parameter is optional. 

When you call DSDI from a batch job the output from this directive is printed in three 
columns, read from top to bottom, one column at a time. When you call DSDI from an 
interactive job the words are displayed one word per line. 

For NOS/VE dumps, the addresses given for the fba and lba parameters must be real 
memory addresses (RMAs) or, when translated to system virtual addresses (SVAs), the 
actual segment identifiers (ASIDs) must match. Also, the dump must contain all central 
memory (not just critical memory), and the FULL option must be specified on the DSDI 
command. Refer to appendix H for NOS/VE address formats to use with the DSDI utility. 
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W — Dump 64-Bit Memory in Word Format 

The W directive is valid on CYBER 180-class machines only. It prints the specified locations 
of 64-bit memory in hexadecimal (4 words of 16 digits per line) with 7-bit ASCII code 
character equivalents. The second format is for NOS/VE dumps. 

Format: 

W, fba, lba, ei . 

or 

W,fba, lba,asid. 

Parameter Description 

fba First byte address, hexadecimal, to be printed (mandatory). 

lba Last byte address, plus one location, to be printed. If lba is omitted, fba+8 is 

assumed by default. 

ei If ei is 1, fba and lba specify byte addresses relative to byte of the 

environment interface. If ei is omitted, fba and lba specify absolute byte 
addresses. 

asid Specifies an actual segment identifier (ASID) for NOS/VE dumps. If you 

specify this parameter, the fba and lba parameters must represent byte 
offsets and have values in the range of from to 7FFFFFFF hexadecimal. 
This parameter is optional. 

For NOS/VE dumps, the addresses given for the fba and lba parameters must be real 
memory addresses (RMAs), or when translated to system virtual addresses (SVAs), the 
actual segment identifiers (ASIDs) must match. Also, the dump must contain all central 
memory (not just critical memory), and the FULL option must be specified on the DSDI 
command. Refer to appendix H for NOS/VE address formats to use with the DSDI utility. 
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PP Dump Directives 

PP dump directives provide the capability to obtain a memory dump of all or selected PPs. 
On some CYBER 180-class machines, the values of the P, Q, K, and A registers are also 
displayed. Two dump formats are available: block format and line format. 

AP — Dump Analysis of PP and PP Memory in Octal Line Format 

The AP directive causes PP memory to be dumped in line format with 6-bit display code 
character equivalents (same format as the Q directive). Repetitive lines are suppressed and 
zero bytes are represented by hyphens ( — ). An analysis of the PP is printed before the 
memory dump. Analysis data includes the associated PP communications area, resident 
entry point call addresses, and read-only variables in direct cells. On some CYBER 
180-class machines, the values of the P, Q, K, and A registers are also displayed. Certain 
direct cell variables are verified and those in error are indicated. 



NOTE 



Correct operation of this directive requires that the PP communication area on the EDD file 
be intact. 



Format: 
Parameter Description 



nj Number of PP to be dumped or a program name. If a program name is 

specified, all PPs executing that program are dumped. A warning message is 
issued if an incorrect number is specified or the program name is not found 
in any PP. If nj is omitted, all active PPs are dumped. 

Refer to Printer Output Listing Examples for a sample of the printer output listing 
produced by this directive. 
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MPP — Move PP 

The MPP directive causes the correct logical PP to be dumped if the logical position of PPOO 
has been changed prior to the full dump to tape. If the PPS-O/PPS-1 toggle switch has been 
toggled, the n parameter should not be specified. If PPOO has to be moved to another PP via 
a deadstart panel program, the n parameter should be specified. 

Format: 

MPP,n. 

Parameter Description 

n Number of PP to which PPOO was moved, n cannot equal 0. If n is omitted, 

10 is assumed (CYBER 170 and CYBER 70 Computer Systems with 20 PPs). 



P — Dump PP Memory in Octal Block Format 

The P directive causes PP memory to be dumped in block format, where each block 
represents 64 words of memory. The blocks are read by column (top to bottom), where each 
column contains eight 12-bit words in octal format numbered through 7. There are eight 
columns in each block, numbered through 7. Repetitive data is not suppressed and zero 
words are represented by hyphens ( — ). For models 865 and 875, bytes 7776 8 and 7777 8 
contain the PFs R register. 

Format: 

P,n 1# n 2 1^. 

Parameter Description 

nj Number of PP to be dumped. If omitted, all PPs are dumped. 
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PF — Dump FLPP Memory in Octal Block Format 

The PF directive causes first-level peripheral processor (FLPP) 1 memory to be dumped in 
block format, where each block represents 64 words of memory. The blocks are read by 
column (top to bottom), where each column contains eight 12-bit words in octal format 
numbered through 7. There are eight columns in each block, numbered through 7. 
Repetitive data is not suppressed and zero words are represented by hyphens ( — ). 

Format: 
Parameter Description 



Number of FLPP to be dumped. If omitted, all FLPPs are dumped. 



PMS — Read PP Select Switches 

The PMS directive causes the dump of the S/C register (maintenance register for models 
865 and 875) to be read to determine the current value of the PP memory select switches 
and the correct logical PP to be dumped, if the logical position of PPOO has been changed 
prior to the full dump to tape. If the PP memory select switches have been changed, this 
directive should be specified with the binary value of the switches prior to the change. This 
directive is meaningful only on a CYBER 170 Computer System with the exception of 
models 815, 825, 835, 845, and 855. 

Format: 

PMS,n. 

Parameter Description 



Previous select switch setting; through 11 8 . If n is the same value as that 
read from the S/C register, this directive is not meaningful. 



1. Hardware manuals define peripheral processors making up a peripheral processor subsystem as PPs. and the first-level peripheral 
processors as peripheral processing units (PPUs). In this manual, first-level peripheral processors are referred to as FLPPs. FLPPs 
are available only on model 176. 



60459300 U Express Deadstart Dump Interpreter (DSDI) 6-19 



Input Directives 



PO — Dump 16-Bit PP Memory in Octal Block Format 

The PO directive is valid on CYBER 180-class machines only. It prints PP memory in block 
format, where each block represents 64 words of memory. DSDI represents each 16-bit word 
by six octal digits. Words whose upper 4 bits are zero are represented by four octal digits. 
Blocks are read by columns (top to bottom), where each column contains eight 16-bit words 
numbered through 7. There are eight columns in each block, numbered through 7. 
Repetitive data is not suppressed and zero words are represented by hyphens ( — ). The 
PP's R register is displayed preceding the first line of the dump. 

Format: 

P0 ' n l' n 2 "m- 

Parameter Description 



nj Number of PP to be dumped. If omitted, all PPs are printed. 



PX — Dump 16-Bit PP Memory in Hexadecimal Block Format 

The PX directive is valid on CYBER 180-class machines only. It prints 16-bit memory in 
block format, where each block represents 256 words of memory. Each 16-bit word is 
represented by four hexadecimal digits. Blocks are read by columns (top to bottom), where 
each column contains sixteen 16-bit words in hexadecimal format numbered through F. 
There are 16 columns in each block, numbered through F. Repetitive data is not 
suppressed and zero words are represented by hyphens ( — ). The PP's R register is 
displayed preceding the first line of the dump. 

Format: 

PX ' n l' n 2 %,• 

Parameter Description ___^________ 

nj Number of PP to be printed. If omitted, all PPs are printed. 
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Q — Dump PP Memory in Octal Line Format 

The Q directive causes PP memory to be dumped in line format with 6-bit display code 
character equivalents. Each line contains 16 bytes (PP words) printed in two sets of 8 bytes 
in octal format. Each set consists of an address, 8 bytes, and display code character 
equivalents. Repetitive lines are suppressed and zero bytes are represented by hyphens 
( — ). Refer to Interactive Use of DSDI later in this section for additional information 
concerning use of this directive from an interactive terminal. 

Format: 

Q< n l< n 2 n m- 

Parameter Description 



Number of PP to be dumped. If omitted, all PPs are dumped. 



QF — Dump FLPP Memory in Octal Line Format 

The QF directive causes FLPP 2 memory to be dumped in line format with 6-bit display code 
character equivalents. Each line contains 16 bytes printed in two sets of 8 bytes in octal 
format. Each set consists of an address, 8 data bytes, and 6-bit display code character 
equivalents. Repetitive lines are suppressed and zero bytes are represented by hyphens ( — ). 

Format: 

QF- n l< n 2 n m- 

Parameter Description ^^ 



nj Number of FLPP to be dumped. If omitted, all FLPPs are dumped. 



2. Hardware manuals define peripheral processors making up a peripheral processor subsystem as PPs, and the first-level peripheral 
processors as peripheral processing units (PPUs). In this manual, first-level peripheral processors are referred to as FLPPs. FLPPs 
are available only on model 176. 
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QOA — Dump 16-Bit PP Memory in Octal/ASCII Line Format 

The QOA directive is valid on CYBER 180-class machines only. It prints PP memory in line 
format with 7-bit ASCII code character representation. Each line contains 16 words printed 
in two sets of eight. Each set consists of an octal address, eight words (six digits per word if 
the upper 4 bits are nonzero, four digits otherwise), and 7-bit ASCII code character 
equivalents. Repetitive lines are suppressed and zero words are represented by hyphens 
( — ). The PP's R register is displayed preceding the first line of the dump. Refer to 
Interactive Use of DSDI later in this section for additional information concerning use of 
this directive from an interactive terminal. 

Format: 

QOA,n 1( n 2 , r^. 

Parameter Description 

n= Number of PP to be printed. If omitted, all PPs are printed. 



QOD — Dump 16-Bit PP Memory in Octal/Display Line Format 

The QOD directive is valid on CYBER 180-class machines only. It prints PP memory in line 
format with 6-bit display code character representation. Each line contains 16 words 
printed in two sets of eight. Each set consists of an octal address, eight words (six digits per 
word if the upper 4 bits are nonzero, four digits otherwise), and 6-bit display code character 
equivalents. Repetitive lines are suppressed and zero words are represented by hyphens 
( — ). The PP's R register is displayed preceding the first line of the dump. Refer to 
Interactive Use of DSDI later in this section for additional information concerning use of 
this directive from an interactive terminal. 

Format: 

QOD,n 1( n 2 r^. 

Parameter Description 

nj Number of PP to be printed. If omitted, all PPs are printed. 
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QXA — Dump 16-Bit PP Memory in Hexadecimal/ASCII Line Format 

The QXA directive is valid on CYBER 180-class machines only. It prints PP memory in line 
format with 7-bit ASCII code character representation. Each line contains 16 words printed 
in two sets of eight. Each set consists of a hexadecimal address, eight words (four 
hexadecimal digits per word), and 7-bit ASCII code character equivalents. Repetitive lines 
are suppressed and zero words are represented by hyphens ( — ). The PP's R register is 
displayed preceding the first line of the dump. Refer to Interactive Use of DSDI later in this 
section for additional information concerning use of this directive from an interactive 
terminal. 

Format: 

QXA,n x ,n 2 i^. 

Parameter Description __^_____ 



Number of PP to be printed. If omitted, all PPs are printed. 



QXD — Dump 16-Bit PP Memory in Hexadecimal/Display Line Format 

The QXD directive is valid on CYBER 180-class machines only. It prints PP memory in line 
format with 6-bit display code character representation. Each line contains 16 words 
printed in two sets of eight. Each set consists of a hexadecimal address, eight words (four 
hexadecimal digits per word), and 6-bit display code character equivalents. Repetitive lines 
are suppressed and zero words are represented by hyphens ( — ). The PP's R register is 
displayed preceding the first line of the dump. Refer to Interactive Use of DSDI later in this 
section for additional information concerning use of this directive from an interactive 
terminal. 

Format: 

QXD, n-pl^ IV 

Parameter Description _^_ 



Number of PP to be printed. If omitted, all PPs are printed. 
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CMR Dump Directives 

The CMR dump directives provide the capability to selectively dump specified areas of 
central memory resident. Refer to the NOS Version 2 Systems Programmer's Instant for 
detailed illustrations of central memory resident. 

Successful use of the CMR dump directives is dependent upon the integrity of central 
memory resident at the time EDD was performed. Most important is the integrity of the 
CMR pointers on the EDD file. If these pointers are not intact, the dump produced by DSDI 
may prove meaningless. Thus, if it is suspected that the CMR pointers are not intact, 
specifying the P keyword on the DSDI command allows DSDI to use the CMR pointers from 
the running system. This option should be used only when the configuration of the running 
system is the same as the system in use at the time the EDD file was created. If the CMR 
pointers on the EDD file are not intact, the integrity of the other areas of central memory is 
also questionable. In this case, the output produced by the CMR dump directives may be 
unpredictable. 

ACCOUNT — Dump Account Dayfile Buffer 

The ACCOUNT directive causes the account dayfile pointers and buffer to be dumped in 
word format (four words per line) with 6-bit display code character equivalents. This format 
is the same format as that for the E memory dump directive. This directive also dumps the 
buffer in a line-by-line format, as on the DSD A display. 

Format: 

ACCOUNT. 

B — Dump Brief Control Point Status 

The B directive dumps all the control points in a format similar to the DSD BA display. 
Format: 

B. 
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CBT — Dump Control Buffer Table 

The CBT directive causes all control buffer table entries to be dumped unless ordinal 
numbers are specified, then only the specified control buffer table entries are dumped. The 
dump is formatted to reflect the appropriate parameter fields for each word. Control buffer 
table entries that are output to a printer are listed in two columns. The format is the same 
format as that for the MST directive. The control buffer table entries can also be output to a 
terminal, but only when ordinal numbers are specified. Control buffer table entries that are 
output to a terminal are listed in a single column format. 

Format: 

CBT,n x ,n 2 r^. 

Parameter Description 

nj Ordinal number of the control buffer table entry to be dumped. If nj is 

omitted, all control buffer table entries are dumped. 



CCT — Dump Channel Control Table 

The CCT directive causes all nonzero channel control table entries to be dumped unless 
ordinal numbers are specified, then only the specified channel control table entries are 
dumped. The dump is formatted to reflect the appropriate parameter fields for each word. 
Channel control table entries that are output to a printer are listed in two columns. The 
format is the same format as that for the MST directive. The channel control table entries 
can also be output to a terminal, but only when ordinal numbers are specified. Channel 
control table entries that are output to a terminal are listed in a single column format. 

Format: 

Parameter Description 

nj Ordinal number of the channel control table entry to be dumped. If nj is 

omitted, all nonzero channel control table entries are dumped. 
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CP — Dump Active Control Point Areas 

The CP directive causes all active control point areas, or a selected subset, to be dumped. 
List options provide the capability to dump only desired portions of the control point area 
and other control point related data. Specified without any parameters, the CP directive 
dumps all active control point areas and pseudo-control point areas. Refer to Interactive 
Use of DSDI later in this section for additional information concerning use of this directive 
from an interactive terminal. 

Format: 

CP. 

or 

CP,n 1 /ops 1 ,n 2 /ops 2 , . . . ,1^/ops,,,. 

Parameter Description 

nj Control point number. 

opsj List options; a string of up to 10 characters indicating the portion of the 

control point area, or control point related data, to be dumped. If list options 
are specified, they apply only to the control point number with which they 
are associated. Valid options are: 

ops,- Description 

X Dumps the exchange package, parameter summary, control 

point's entry in the executing job table, and contents of the 
memory locations indicated by the values in each exchange 
package register. These register values are treated as relative 
addresses within the field length; invalid addresses are 

represented with contents of zero. 

The current command and special entry point parameters are 

not printed for the system control point. Refer to Printer Output 

Listing Examples later in this section for a sample of the printer 

output listing produced. 

T Provides a detailed dump of the control point area with a 

description of each parameter field and NOSTEXT symbol for 
each word. 

A 3 Dumps the job dayfile pointers and buffer in word format with 

6-bit display code character equivalents. This format is the same 
format as the E memory dump directive. This option also dumps 
the buffer in a line-by-line format, as on the DSD A display. 

F 3 Provides a dump of the 3-word FNT entry, EST, and mass 

storage track chain, if one exists, for all files attached to the 
specified control point. 



This option does not dump information for the system control point. 
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Parameter Description 



opsj (Continued) 

opSj Description 



C 4 Dumps the field length of a specified control point in instruction 

parcel format with 6-bit display code character equivalents. This 
format is the same format as the C memory dump directive. 
Repetitive data is suppressed. 

D 4 Dumps the field length of a specified control point in byte format 

with 6-bit display code character equivalents. This format is the 
same format as the D memory dump directive. Repetitive data is 
suppressed. 

E 4 Dumps the field length of a specified control point in word format 

with 6-bit display code character equivalents. This format is the 
same format as the E memory dump directive. 

G Dumps the control point area in instruction parcel format with 

6-bit display code character equivalents. This format is the same 
format as the C memory dump directive. 

H Dumps the control point area in byte format with 6-bit display 

code character equivalents. This format is the same format as 
the D memory dump directive. 

I Dumps the control point area in word format with 6-bit display 

code character equivalents. This format is the same format as 
the E memory dump directive. 

M 4 Dumps the user-accessible extended memory of a specified 

control point in byte format with 6-bit display code character 
equivalents. This format is the same format as the D memory 
dump directive. 

N 4 Dumps the negative field length of a specified control point. This 

format is the same format as the D memory dump directive. 

P Provides a dump and analysis of all active PPs associated with 

control point n. 

default If n is specified with no corresponding list options, options XTAF 
are selected automatically. Refer to Printer Output Listing 
Examples later in this section for a sample of the printer output 
listing produced. The default options selected can be changed 
with the CPO directive. 



4. This option does not dump information for the system control point. 
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All of the list options specified for a particular control point area (up to 10) are processed. 
For example, if the C and D options are both specified, the control point field length is 
dumped twice, once in instruction parcel (C) format and again in byte (D) format. 

CPO — Reset Default List Options 

The CPO directive selects a new string of default fist options for the CP directive. 
Format: 

CPO, ops. 

Parameter Description 



ops New default fist options for CP directive, a string of up to 10 characters. 

Refer to the description of the CP directive for a list of valid option 
characters. 



CT — Dump Channel Tables 

The CT directive causes the channel status table, EJT assignment table, and channel 
controlware table to be dumped in byte format with 6-bit display code character equivalents. 
This format is the same format as that for the D memory dump directive. 

Format: 

CT. 

DAYFILE — Dump System Dayfile Buffer 

The DAYFILE directive causes the system dayfile pointers and buffer to be dumped in word 
format (four words per line) with 6-bit display code character equivalents. This format is 
the same format as that for the E memory dump directive. This directive also dumps the 
buffer in a line-by-line format, as on the DSD A display. 

Format: 

DAYFILE . 

DB — Dump Disk Buffers 

The DB directive causes all disk buffers, or a selected subset, to be dumped to a printer in 
byte format with 6-bit display code character equivalents. This format is the same format 
as that for the D memory dump directive. 

Format: 

DB.id.ri!,!^ rv 
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Parameter Description 



id Specifies the machine identifier of the main fr ame from which to dump the 

disk buffers. If id is omitted, the default machine identifier is taken from 
CMR of the mainframe that is dumping the disk buffers. 

nj Number assigned to a disk buffer to be dumped. If r^ is omitted, all active 

disk buffers are dumped. 



DBW — Dump Buffered Device/Buffer Statistics/PP-I/O Buffer Link Tables 

The DBW directive causes the fist control words from the buffered device table, the buffer 
statistics table, and the PP-I/O buffer link table to be dumped. The dump is formatted to 
reflect the appropriate parameter fields for each word. Output to a printer is listed in two 
columns. Output to a terminal is listed in one column. The format is the same format as 
that for the MST directive. 

Format: 

DBW. 

DDB — Dump Dayfile Dump Buffer 

The DDB directive causes the dayfile dump buffer to be dumped in byte format with 6-bit 
display code character equivalents. This format is the same format as that for the D 
memory dump directive. 

Format: 

DDB. 

DP — Dump Dayfile Buffer Pointers 

The DP directive causes the dayfile buffer pointers to be dumped in byte format with 6-bit 
display code character equivalents. This format is the same format as that for the D 
memory dump directive. 

Format: 

DP. 

EICB — Dump Environment Interface Communication Buffer 

The EICB directive causes the environment interface (EI) communication buffer to be 
dumped. The dump is formatted to reflect the appropriate parameter fields and COMSDFT 
symbols for each word. This directive also dumps the dedicated fault tolerance/operating 
system (DFT/OS) buffer in instruction parcel format (four groups of four hexadecimal digits 
with 7-bit ASCII code character equivalents). 
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EJT — Dump Executing Job Table 

The EJT directive provides a detailed dump of each entry in the executing job table, 
including a description of each parameter field and the NOSTEXT symbol for each word. 

Format: 

EJT. 

EPB — Dump Extended Memory/PP Buffer 

The EPB directive causes the extended memory/PP buffer to be dumped in byte format with 
6-bit display code character equivalents. This format is the same format as that for the D 
memory dump directive. 

Format: 

EPB. 

ERRLOG — Dump Error Log Buffer 

The ERRLOG directive causes the error log pointers and buffer to be dumped in word 
format (four words per Hue) with 6-bit display code character equivalents. This format is 
the same format as that for the E memory dump directive. This directive also dumps the 
buffer in a line-by-line format, as on the DSD A display. 

Format: 

ERRLOG. 

EST — Dump Equipment Status Table 

The EST directive provides a detailed dump of each entry in the equipment status table, 
with a description of each entry and the NOSTEXT symbol for each word. 

Format: 

EST. 

FNT — Dump System File Name/File Status Table 

The FNT directive provides a detailed dump of each entry in the system file name/file status 
table, with a description of each entry and the NOSTEXT symbol for each word. 

Format: 

FNT. 
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FOT — Dump Family Ordinal Table 

The FOT directive causes the family ordinal table to be dumped in byte format with 6-bit 
display code character equivalents. This format is the same format as that for the D 
memory dump directive. 

Format: 

FOT. 

HAT — Dump Hash Table 

The HAT directive causes all nonzero hash table entries to be dumped unless ordinal 
numbers are specified, in which case only the specified hash table entries are dumped. The 
dump is formatted to reflect the appropriate parameter fields for each word. Hash table 
entries that are output to a printer are listed in two columns. The format is the same 
format as that for the MST directive. The hash table entries can also be output to a 
terminal, but only when ordinal numbers are specified. Hash table entries that are output 
to a terminal are listed in a single-column format. 

Format: 

HATMi-pr^ iv 

Parameter Description 



Ordinal number of the hash table entry to be dumped. If nj is omitted, all 
nonzero hash table entries are dumped. 



JC — Dump Job Control Area for Each Service Class 

The JC directive causes the job control area for each job service class to be dumped. The 
dump is formatted to reflect the appropriate parameter fields and NOSTEXT symbol for each 
word. This directive also dumps the service class control table (SCT) in a line-by-line format. 

Format: 

JC. 

LC — Dump Low Central Memory 

The LC directive causes DSDI to dump the contents of low central memory (that is, central 
memory locations through 177 8 ). Each word is divided into the appropriate parameter 
fields. Each field is listed on a separate line with a description of the parameter. The 
absolute address and 6-bit display code character equivalents are also listed for each word. 

Format: 

LC. 
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LDIS — Dump L-Display Buffer 



The LDIS directive causes the L-display buffer to be dumped in instruction parcel format 
with 6-bit display code character equivalents. This format is the same format as that for the 
C memory dump directive. 

Format: 

LDIS. 

LIDT — Dump Logical Identifier Table 

The LIDT directive causes the logical identifier table to be dumped in byte format with 6-bit 
display code character equivalents. This format is the same format as that for the D 
memory dump directive. 

Format: 

LIDT. 

MAINLOG — Dump Binary Maintenance Log Buffer 

The MAINLOG directive dumps the binary maintenance log pointers and buffer in word 
format, four words per line, with 6-bit display code character equivalents. 

Format: 

MAINLOG . 

MCT — Dump Memory Control Table 

The MCT directive dumps the contents of the memory control table (MCT). For each control 
point and pseudo-control point, there are two lines. The first line displays the control point 
(or pseudo-control point) having the next lower reference address, the one having the next 
higher reference address, the unassigned CM Fl/100 8 between the control point (or 
pseudo-control point) having the next higher reference address, and the job's reference 
address, field length, negative field length, and one byte of recovery information. The second 
line displays the corresponding information for extended memory. 

Format: 

MCT. 
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MST — Dump Mass Storage/Track Reservation Tables 

The MST directive dumps the MST (Mass Storage Table) and the TRT (Track Reservation 
Table) for the specified device(s). If no devices are specified, the MST directive dumps all 
mass storage devices. If the specified device is a shared device, the MRT (Mass Storage 
Recovery Table) is also dumped. If the device is a shared buffered device, the BST (Buffer 
Status Table) is also dumped. 

The dump format for the mass storage tables reflects the appropriate parameter fields and 
NOSTEXT symbol of each word. The portion of the dump describing the track reservation 
tables is presented in byte format with 6-bit display code character equivalents. The track 
link byte ordinal and status bits (three groups of 4 bits) are indicated for each word. The 
MRT and the BST, if present, are dumped in a format similar to the TRT. Refer to Printer 
Output Listing Examples later in this section for a sample of the printer output listing 
produced by this directive. 

Format: 

MST,est 1 ,est 2 , - - • . est n . 

Parameter Description 

estj EST ordinal of equipment whose mass storage table is to be dumped. If est; 

is omitted, all mass storage and track reservation tables are dumped. 



MTR — Dump CPU Monitor 

The MTR directive causes the CPU monitor to be dumped. Exchange packages are dumped 
in exchange package format. The program area is dumped, using relative addressing in 
instruction parcel format with 6-bit display code character equivalents. This format is the 
same format as that for the C memory dump directive. 

Format: 

MTR. 
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MTRQUEUE — Dump CPUMTR Request and Recall Queues 

The MTRQUEUE directive causes all CPUMTR request and recall queues, or a selected 
subset, to be dumped. 

Format: 

MTRQUEUE , idents . 

Parameter Description 

idents A string of up to four characters indicating the queues to be dumped. The 

queue identifiers can be specified in any order and are dumped in the order 
specified. Default is to dump all four queues. Valid queue identifiers are: 



idents 


Queue Name 


C 


CPUCIO request. 


P 


PP request. 


R 


Recall. 


W 


CPU request. 



ODIS — Dump Operator Display Buffer 

The ODIS directive causes the operator display buffer (used for communication between an 
operator and a remote diagnostic user) to be dumped in instruction parcel format with 6-bit 
display code character equivalents. This format is the same format as that for the C 
memory dump directive. 

Format: 

ODIS. 

PCP — Dump Pseudo-Control Point 

The PCP directive causes all active pseudo-control point areas, or a selected subset, to be 
dumped. The format is the same as that for the CP control point dump directive. 
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PLD — Dump Peripheral Library Directory 

The PLD directive causes the PP library directory to be dumped in byte format with 6-bit 
display code character equivalents. This format is the same format as that for the D 
memory dump directive. 

Format: 

PLD. 

PP — Dump PP Communication Areas 

The PP directive causes the contents of all PP communication areas to be dumped in byte 
format with 6-bit display code character equivalents. This format is the same format as that 
for the D memory dump directive. The control point assignment, channel assignment, and 
monitor function are listed with each communication area. Refer to Printer Output Listing 
Examples later in this section for a sample of the printer output listing produced by this 
directive. Refer to Interactive Use of DSDI later in this section for additional information 
concerning use of this directive from an interactive terminal. 

Format: 

pp. 

PROBE — Dump PROBE Data Tables 

The PROBE directive causes the PROBE data tables to be dumped in byte format with 6-bit 
display code character equivalents. 

Format: 

PROBE . 

PST — Dump Program Status Table and Entry Point Directory 

The PST directive causes the program status table and the entry point directory to be 
dumped in byte format with 6-bit display code character equivalents. This format is the 
same format as that for the D memory dump directive. 

Format: 

PST. 
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PUT — Dump Physical Unit Table 

The PUT directive causes all nonzero physical unit table entries to be dumped unless 
ordinal numbers are specified, then only the specified physical unit table entries are 
dumped. The dump is formatted to reflect the appropriate parameter fields for each word. 
Physical unit table entries that are output to a printer are listed in two columns. The 
format is the same format as that for the MST directive. The physical unit table entries can 
also be output to a terminal, but only when ordinal numbers are specified. Physical unit 
table entries that are output to a terminal are fisted in a single column format. 

Format: 

PUT,n 1( n 2 n,. 

Parameter Description ^^_ 

nj Ordinal number of the physical unit table entry to be dumped. If nj is 

omitted, all nonzero physical unit table entries are dumped. 



QPT — Dump Queued File Table 

The QFT directive provides a detailed dump of each entry in the queued file table, with a 
description of each parameter field and the NOSTEXT symbol for each word. 

Format: 

QFT. 

RCL — Dump Resident Central Library 

The RCL directive causes the resident CPU library to be dumped in instruction parcel 
format with 6-bit display code character equivalents. This format is the same format as that 
for the C memory dump directive. A warning is printed if the resident central library is 
empty. 

Format: 

RCL. 
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RPL — Dump Resident Peripheral Library 

The RPL directive causes the resident PP library to be dumped in byte format with 6-bit 
display code character equivalents. This format is the same format as that for the D 
memory dump directive. A header line for each PP program dumped indicates the name of 
the program and its length in bytes. Each succeeding line contains 10 bytes (two central 
memory words) of the PP program. The PP address of the first byte in each line, relative to 
address zero of the PP, is also listed. 

Format: 

RPL. 

SAB — Dump System Attribute Block 

The SAB directive causes the system attribute block to be dumped in byte format with 6-bit 
display code character equivalents. This format is the same format as that for the D 
memory dump directive. 

SDA — Dump Extended Statistical Data Area 

The SDA directive causes the extended statistical data area to be dumped. Each word is 
divided into the appropriate parameter fields and is listed with a description of the 
parameter. The absolute address and 6-bit display code character equivalents are also listed 
for each word. 

Format: 

SDA. 

SECDED — Dump SECDED Identifier Table 

The SECDED directive causes the single error correction double error detection (SECDED) 
identifier table to be dumped in byte format with 6-bit display code character equivalents. 
This format is the same format as that for the D memory dump directive. 

Format: 

SECDED. 
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SST — Dump Subsystem Control Point/Subsystem Assignment Tables 

The SST directive causes the subsystem control point table and subsystem assignment table 
to be dumped in byte format with 6-bit display code character equivalents. This format is 
the same format as that for the D memory dump directive. 

Format: 

SST. 

TBDUMP — Dump Trace Buffer 

The TBDUMP directive dumps the specified trace buffer. The functions traced are listed, 
followed by the absolute and control point area addresses that were saved, and the buffer 
IN pointer. The trace buffer data is displayed in the same format as that for the D memory 
dump directive. 

Format: 

TBDUMP, MTR. 

or 

TBDUMP, PPU. 

Parameter Description 

MTR MTR to CPUMTR function trace buffer. 

PPU PP to CPUMTR function trace buffer. 
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Subsystem Dump/Analysis Directives 

The subsystem dump/analysis directives provide the capability to selectively dump portions 
of central and/or PP memory associated with a specific subsystem (BIO, IAF, MAG, and 
RHF). Although many other directives already described in this section can be used to dump 
the same areas of memory, these directives dump those areas most frequently analyzed 
when subsystem-related malfunctions occur. In addition, many of the dumps are specially 
formatted to provide a detailed description of the area being dumped. If the specified 
subsystem was not active at the time the EDD file was created, an error message is issued. 

BATCHIO (BIO) — Dump Associated Memory for Analysis 

The BATCHIO directive causes the areas of central and/or PP memory that are most 
frequently analyzed when BATCHIO malfunctions are indicated to be dumped. The areas 
and type of memory dumped are determined by the list options specified. 

Formats: 

BATCHIO, ops. 
or 

BIO, ops. 

Parameter Description 



ops List options; a string of characters indicating the areas of memory to be 

dumped. If no options are specified, all three options (PBN) are selected by 
default and are processed in order as listed. 



ops Description 



P Provides analysis and full memory dump of PPs having resident 

copies of 1CD, HO, QAP, QAC, or DSP. The output fisting 
generated is the same (in format and content) as that produced by 
entering the AP directive in this format: 

AP , 1CD , 110 , QAP , QAC , DSP . 

Refer to the description of the AP directive earlier in this section 
for additional information. 

B Provides specially formatted dumps of each active BATCHIO 

buffer point. Included with the dump of each buffer point is the 
associated equipment type and FET, as well as EST and FNT/FST 
entries. 

N Provides a dump of the negative field length associated with the 

BATCHIO control point in byte format with 6-bit display code 
character equivalents. This format is the same format as that for 
the D memory dump directive. 
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IAF — Dump Associated Memory for Analysis 

The IAF directive causes the areas of central and/or PP memory that are most frequently 
analyzed when IAF malfunctions to be dumped. The areas and type of memory are 
determined by the list options specified. The IAF current entry word (SSPA) is always 
printed at the beginning of the listing, in byte format, regardless of which list options are 
specified. 

Format: 

IAF, ops. 

Parameter Description 

ops List options; a string of up to five characters indicating the areas of memory 

to be dumped. If no options are specified, four options (ETLP) are selected by 
default and processed in order as listed. 

ops Description 

C Provides analysis of the IAF command table. 

E Dumps the IAF reentry table in byte format (two words per line) 

with 6-bit display code character equivalents. The first word in 
each line is preceded by its ordinal within the table. 

T Provides a specially formatted dump of the IAF terminal table in 

which each word reflects the appropriate parameter fields. The 
message status table entry is included when dumping network 
terminal tables. In addition, each word is preceded by a 
description of the parameter fields and its COMSREM symbol. 
Terminal table entries that are empty, except for having status 
bit in word 3 (VROT entry) set, are not printed. 

L Provides a dump of pot link table and all pots. The pot link table 

is dumped in byte format with pot link byte ordinals indicated for 
each word, but no 6-bit display code character equivalents. 
Repetitive pot link table entries are suppressed. The pots are 
dumped in word format, three lines per pot, with the first line 
containing only the pot number. 

P Provides analysis and full memory dump of all PPs having 

resident copies of TLX, 1TA ITN, and 1TO. This option also 
provides an analysis and dump of all PPs having resident copies 
of 1RO and 1RI that are associated with control points of 
interactive origin. The output fisting generated is the same (in 
format and content) as that produced by entering the AP directive 
in this format: 

AP,TLX, 1TA, ITN, 1TO, 1RO, 1RI. 

The exception is that the AP directive also dumps all PPs having 
copies of 1RO and 1RI rather than only those associated with 
control points of interactive origin. Refer to the description of the 
AP directive, earlier in this section, for additional information. 
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MAGNET (MAG) — Dump Associated Memory for Analysis 

The MAGNET directive causes the areas of central and/or PP memory that are most 
frequently analyzed when a malfunction within the Magnetic Tape Subsystem is indicated 
to be dumped. The areas and type of memory dumped are determined by the list options 
specified. 

Format: 

MAGNET , ops . 

or 

MAG, ops. 

Parameter Description 



ops list options; a string of characters indicating the areas of memory to be 

dumped. If no options are specified, all four options (UQSP) are selected by 
default and are processed in order as listed. 

ops Description 

U Provides a specially formatted dump of the Magnetic Tape 

Subsystem unit descriptor tables with associated FET, EST, and 
FNT/FST. Each word of a unit descriptor table is formatted to 
reflect appropriate parameter fields. In addition, each word is 
preceded by a description of the parameter fields and its 
COMSMTX symbol. If extended labels are present, they appear 
with the FET in the output listing. The FET also indicates the 
address and control point number of the user. 

Q Provides a dump of the Magnetic Tape Subsystem queue table in 

byte format (two words per line) with 6-bit display code character 
equivalents. The first word in each line is preceded by its ordinal 
within the table. 

S Provides a dump of the Magnetic Tape Subsystem active stage job 

table, staging tape VSN list, and stage request table, if they are 
defined. The tables are dumped in byte format (two words per 
line) with 6-bit display code character equivalents. The first word 
in each line is preceded by its ordinal within the table. 

P Provides analysis and full memory dump of all PPs having 

resident copies of 1MT. The output listing generated is the same 
(in format and content) as that produced by entering the AP 
directive in this format: 

AP,1MT. 

Refer to the description of the AP directive earlier in this section 
for additional information. 
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RHF — Dump Associated Memory for Analysis 

The RHF directive causes the areas of central and/or PP memory that are most frequently 
analyzed when RHF malfunctions are indicated to be dumped. The areas and type of 
memory dumped are determined by the list options specified. 

Format: 

RHF, ops. 

Parameter Description 

ops List options; a string of characters indicating the areas of memory to be 

dumped. If no options are specified, all three options (ACP) are selected by 
default and are processed in order as listed. 

ops Description 

A Provides a dump of the RHF dayfile buffer in word format with 

6-bit display code character equivalents. This format is the same 
format as that for the E memory dump directive. This option also 
dumps a standard dayfile. 

C Provides a dump of the RHF field length in byte format with 6-bit 

display code character equivalents. This format is the same 
format as that for the D memory dump directive. 

P Provides analysis and full memory dump of all active PPs 

associated with the control point. 
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Hardware Register Dump Directives 

The hardware register dump directives provide the capability to dump specified hardware 
registers. 



FMFREG — Dump PP Registers 

The FMFREG directive is valid on CYBER 180-class machines only. For each PP register 
(P, Q, K, A) stored while processing a fatal mainframe error, DSDI prints the PP register 
contents. 

Format: 

FMFREG. 



IOUCR — Dump Concurrent PP Channel Registers 

The IOUCR directive is valid only on CYBER machines that support concurrent channels 
and concurrent PPs. For each concurrent PP channel specified, DSDI prints the channel 
number, channel type, IOU status register contents, T register contents, fault status mask, 
and test mode operand generator. The channel number and channel type are octal; all of 
the other fields are hexadecimal. 

Format: 

IOUCR, ch x , ch 2 , . . . , ch^. 

Parameter Description 

chj Channel number of the concurrent PP channel register to be printed. If 

omitted, all concurrent PP channel registers are printed. 



IOUMR — Dump IOU Maintenance Registers 

The IOUMR directive is valid on CYBER 180-class machines only. For each input/output 
unit (IOU) maintenance register specified, DSDI prints the hexadecimal register number, 
the register contents, and the register description. For registers cont ainin g error indicators, 
DSDI prints a description of each error. 

Format: 

IOUMR, first, last. 

Parameter Description 

first First register (hexadecimal) to be printed. If omitted, printing begins with 

register 00. 

last Last register +1 (hexadecimal) to be printed. If omitted, printing ends with 

register first+1. 

If no parameters are specified, DSDI prints all maintenance registers. 
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LPVA — Load Central Memory PVA into Pseudo Register 

The LPVA directive is valid on CYBER 180-class machines only. You use this directive 
when you are doing an analysis of a NOS/VE dump tape. The dump must contain all 
memory (not just critical memory), and the FULL option must be specified on the DSDI 
command. The LPVA directive retrieves a copy of 48 bits starting at the specified address 
and loads them into the pseudo register named PVA (Process Virtual Address). This value 
is printed at your terminal and saved for use by subsequent directives. 

Format: 

LPVA, address , offset . 

Parameter Description 

address Specifies the beginning byte address of the 48 bits loaded into PVA You can 

enter this parameter in any of the acceptable NOS/VE address formats. 
Refer to appendix H for NOS/VE address formats to use with the DSDI 
utility. This parameter is required. 

offset Specifies the hexadecimal number of bytes from the start-address to begin 

loading the 48-bit address. This parameter is optional. 



MEMMR — Dump Memory Maintenance Registers 

The MEMMR directive is valid on CYBER 180-class machines only. For each memory 
maintenance register specified, DSDI prints the hexadecimal register number, the register 
contents, and the register description. For registers containing error indicators, DSDI prints 
a description of each error. 

Format: 

MEMMR, first, last. 

Parameter Description 

first First register (hexadecimal) to be printed. If omitted, printing begins with 

register 00. 

last Last register+1 (hexadecimal) to be printed. If omitted, printing ends with 

register first+1. 

If no parameters are specified, DSDI prints all maintenance registers. 
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PROCA — Dump Processor Operand Cache 

The PROCA directive is valid on CYBER 180 model 990 and 995 machines only. This 
directive prints the contents of the processor operand cache (POC) record from the EDD file. 
The dump format has three columns. The first column contains the specified word numbers, 
the second column contains the contents of the corresponding words from the control 
memory part of the POC record in hexadecimal, and the third column contains the contents 
of the corresponding words from the data memory part of the POC record in hexadecimal. 

Format: 

PROCA, first, last . 

Parameter Description 



first First word number (hexadecimal) to be printed. If omitted, printing begins 

with word 0. 

last Last word number (hexadecimal) to be printed. If you specify first but omit 

last, printing ends with word first+1. If you omit both first and last, printing 
ends with word FFF 16 . 



PROCW — Dump Processor Controlware Part Number and Revision Level 

The PROCW directive is valid on CYBER 180-class machines only. It prints the processor 
controlware part number and the revision level. For model 990 and 995 machines, DSDI 
extracts the controlware revision level and date from the last 256-bit word of the processor 
control store (PCS) record from the EDD file. 

Format: 

PROCW. 



PROMR — Dump Processor Maintenance Registers 

The PROMR directive is valid on CYBER 180-class machines only. For each processor 
maintenance register specified, DSDI prints the hexadecimal register number, the register 
contents, and the register description. For registers containing error indicators, descriptions 
of each error are printed. 

Format: 

PROMR, first, last. 

Parameter Description 



first First register (hexadecimal) to be printed. If omitted, printing begins with 

register 00. 

last Last register+1 (hexadecimal) to be printed. If omitted, printing ends with 

register first+1. 

If no parameters are specified, all maintenance registers for both processors are printed. If 
first and last are specified, then the specified registers are dumped for all processors. 
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PROPM — Dump Processor Page Map 

The PROPM directive is valid on CYBER 180 model 990 and 995 machines only. The 
directive prints the contents of the processor page map (PPM) record from the EDD file. The 
listing consists of 128 data fines plus column headings. Each line contains a set number (0 
to 3), the entry number (0 to 1F 16 ) within its set, and the contents of that entry in 
hexadecimal. 

Format: 

PROPM. 

PRORF — Dump Processor Register File 

The PRORF directive is valid on CYBER 180-class machines only. For all CYBER 180-class 
machines except models 990 and 995, it prints the maintenance channel interface port 
number followed by the hexadecimal register number and contents of each processor 
register specified. 

Format: 

PRORF , first , last . 

Parameter Description ____^______ 

first First register to be printed. If omitted, printing begins with register 00. 

last Last register+1 to be printed. If omitted, printing ends with register first+1. 

If no parameters are specified, the entire register file for both processors is printed. If first 
and last are specified, then the specified registers are dumped for all processors. 

For CYBER 180 model 990 and 995 machines, enter the PRORF directive without 
parameters. DSDI produces a fisting of the entire contents of each of the following records 
from the EDD file: PRF, PIS, PRG, and PRH. Refer to Printer Output Listing Examples 
later in this section for a sample of the listing DSDI produces for model 990 and 995 
machines. 

PROSM — Dump Processor Segment Map 

The PROSM directive is valid on CYBER 180 model 990 and 995 machines only. The 
directive prints the contents of the processor segment map (PSM) record from the EDD file. 
The listing consists of 64 data lines plus column headings. Each line contains a set number 
(0 or 1), the entry number (0 to 1F 16 ) within its set, and the contents of that entry in 
hexadecimal. 

Format: 

PROSM. 
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PROXP — Dump Processor Exchange Package 

The PROXP directive is valid on CYBER 180-class machines only. It prints the 
maintenance channel interface port number followed by the hexadecimal register number, 
the contents of each processor register, and (for most registers) a description of the 
register's contents. The exchange packages for all processors are printed. 

Format: 

PROXP. 

For NOS/VE dumps, use the following format: 

PROXP, address . 

Parameter Description ^ 



address Specifies the first byte address of the exchange package. You can enter this 

parameter in any of the acceptable NOS/VE address formats. Refer to 
appendix H for NOS/VE address formats to use with the DSDI utility. If you 
omit this parameter, the current contents of the central processor registers 
are printed. If the memory address you specify is for the stack frame save 
area, the only registers printed are the registers recorded in the save area. 



SC — Dump S/C Register 

The SC directive is valid only on CYBER 170 Computer Systems with the exception of 
models 815, 825, 835, 845, and 855; it causes the S/C registers (maintenance registers for 
models 865 and 875) to be dumped. 

Format: 

sc. 

SETCPU — Set CPU Number 

The SETCPU directive is valid on any CYBER model that supports 170 mode in both CPUs. 
It sets up processor pointers for the CPU specified in the directive. 

Format: 

SETCPU , number . 

Parameter Description 



number Specifies the number of the CPU (0 or 1). Default is 0. 
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SETTOU — Set PP Dump Defaults 

The SETIOU directive presets the parameter defaults for processing PP memory dumps to 
allow printing of concurrent PP memory. 

Format: 

SETIOU, option. 

Parameter Description 

option Specifies whether to process concurrent PPs or nonconcurrent PPs. If no 

option is specified, option N is assumed. 

option Description 

C Process concurrent PPs to allow printing 8192 words of 

concurrent PP memory. This option is valid only on CYBER 
machines that support concurrent channels and concurrent PPs. 

N Process nonconcurrent PPs to allow printing 4096 words of PP 

memory. 



SET JPS — Change the JPS Register Value 

The SETJPS directive is valid on CYBER 180-elass machines only. You use this directive 
when you are doing an analysis of a NOS/VE dump tape. The dump must contain all 
memory (not just critical memory), and the FULL option must be specified on the DSDI 
command. The SETJPS directive sets the pseudo register named JPS (Job Process State) to 
a value different than the value of the JPS register found in the dump. 

Format: 

SETJPS , address . 

Parameter Description 

address Specifies the location of, or the actual new value for, the JPS register. You 

can enter this parameter in any of the acceptable NOS/VE address formats. 
Refer to appendix H for NOS/VE address formats to use with the DSDI 
utility. If you specify address as a process virtual address (PVA) or system 
virtual address (SVA), the system loads the value stored at that location into 
the pseudo JPS register. If you specify address as a real memory address 
(RMA), the system loads that value into the pseudo JPS register. This 
parameter is required. 
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SETRMA — Convert Address into RMA 

The SETRMA directive is valid on CYBER 180-class machines only. You use this directive 
when you are doing an analysis of a NOS/VE dump tape. The dump must contain all 
memory (not just critical memory), and the FULL option must be specified on the DSDI 
command. The SETRMA directive converts the specified address into a real memory 
address (RMA) and saves that value in a pseudo register (called RMA) for use in subsequent 
directives. 

Format: 

SETRMA, address . 

Parameter Description 



address Specifies the address to be converted to an RMA. You can enter this 

parameter in any of the acceptable NOS/VE address formats. Refer to 
appendix H for NOS/VE address formats to use with the DSDI utility. This 
parameter is required. 



SETVEP — Set Virtual Address Parameters 

The SETVEP directive is valid on CYBER 180-class machines only. You can use this 
directive when you are doing an analysis of a NOS/VE dump tape. The dump must contain 
all memory (not just critical memory), and the FULL option must be specified on the DSDI 
command. The SETVEP directive changes the virtual memory parameters used for the 
NOS/VE DSDI memory display directives (I and W). 

Format: 

SETVEP, address , length, mask, mps . 



Parameter Description 

address Specifies the beginning address of the page table as a hexadecimal number 
of from 1 to 6 digits. This parameter is required. 

length Specifies the length of the page table as a hexadecimal number of from 1 to 6 

digits. This parameter is required. 

mask Specifies the value of the page size mask as a hexadecimal number of from 1 

to 6 digits. This parameter is required. 

mps Specifies the contents of the pseudo register named monitor process state 

(MPS) as a hexadecimal number of from 1 to 6 digits. This parameter is 
required. 
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TRACEBK — Traceback Stack Frame Save Area 

The TRACEBK directive is valid on CYBER 180-class machines only. You use this directive 
when you are doing an analysis of a NOS/VE dump tape. The dump must contain all 
memory (not just critical memory), and the FULL option must be specified on the DSDI 
command. The TRACEBK directive displays the exchange package found at the specified 
address; and, for each stack frame, the module name and contents of the registers saved. 

Format: 

TRACEBK , address . 

Parameter Description 

address Specifies the address of the exchange package where the traceback starts. 

You can enter this parameter in any of the acceptable NOS/VE address 
formats. Refer to appendix H for NOS/VE address formats to use with the 
DSDI utility. If you omit this parameter, the system uses the exchange 
package currently in the central processor. 

If you enter this directive interactively, the output includes just the minimum save area 
(the P register and address registers AO, Al, and A2). If you enter this directive in a batch 
job with line printer output, the output contains the entire stack frame as saved by the 
task. The actual contents depends on the information saved by the task. 

XP • Dump Deadstart Exchange Package 

The XP directive causes the CPU exchange package executing at the time of deadstart to be 
dumped. If there are two CPUs in the system, both exchange packages in execution at the 
time of deadstart are dumped. 

Format: 

XP. 
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Buffer Controller Directive 

The buffer controller (BCDUMP) directive provides the capability to dump specified buffer 
controllers and list verification information for controlware dump files. The BCDUMP 
directive can interpret either a dump file produced by the LOADBC utility or a dump file 
produced by EDD. If the dump file was produced by EDD, the dump buffer controller option 
must have been selected at the time the dump was taken, and the FULL option must be 
specified on the DSDI command. The BCDUMP directive causes the selected buffer 
controllers to be dumped. 

Format: 

BCDUMP/ ops . 

or 

BCDUMP, cc 1 ,cc 2 , . . . ,cc n . 

or 

BCDUMP, cc-jyops^cc^/opsj, . . . ,cc n /ops n . 

Parameter Description ^ 



cc- Channel number of buffer controller to be dumped. If no channels are 

specified, all buffer controllers are dumped. 

opsj List options; a character string indicating the line format, interpretation, 

and verification of the selected buffer controllers to be dumped. If no options 
are specified, options H and D are selected by default. 

ops; Line Format 



H Hexadecimal line format (default). 

O Octal line format. 

Options A and D indicate interpretation. 
ops, Interpretation 



A 7-bit ASCII code interpretation. 

D 6-bit display code interpretation (default). 

The following options indicate verification. 
ops ; Verification 



V List verification information (used with the controlware dump 
file produced by the LOADBC utility). 

V omitted Do not list verification information. 
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Interactive Use of DSDI 

Incorporated within DSDI is an interactive facility that allows several of the directives 
already described in this section to be entered interactively from a terminal. This 
interactive facility is designed to provide the following additional capabilities. 

• Allows preliminary examination of the EDD file to determine which areas should be 
listed in detail at a line printer. 

• Allows examination of certain areas of the EDD file not listed during normal 
operational procedures following a system malfunction. Typically, predefined portions of 
the EDD file are listed following a system malfunction. 

• Allows online examination of the EDD file from a remote location. 

Refer to Example of DSDI Terminal Use later in this section for an example showing 
interactive use of DSDI. 

When the DSDI command is entered from an interactive terminal, there will be a 10- to 
60-second delay before input directives can be entered. During this delay, DSDI is copying 
the EDD file to a random-access mass storage file. The length of the delay depends on 
device speed and current system activity. When DSDI is able to accept input directives, it 
will issue the following prompt to the terminal. 

ENTER DIRECTIVES- - 
■p 

Directives are entered following the question mark prompt. Only one directive can be 
entered at a time, and each directive is restricted to one line. The format is the same as 
described for batch input (refer to Directive Format earlier in this section). 

Generally, any of the DSDI input directives can be entered at an interactive terminal. 
However, the output produced by many of the directives is formatted for listing only at a 
line printer (136 columns) and cannot be listed at the terminal (72 columns). The L 
parameter on the DSDI command initially determines the disposition of the fist output. If a 
file name is not specified, fist output is assigned to file OUTPUT by default (that is, the 
terminal). In this case, entry of directives that produce output that cannot be listed at the 
terminal results in the message: 

DIRECTIVE RESTRICTED TO PRINTER OUTPUT. 

If a list output file name is specified on the DSDI command, all input directives can be 
entered at the terminal. All list output (including error messages) is written to the specified 
file. 
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These two input directives are provided to further control the disposition of list output: 



Directive 



Description 



OUTPUT,filename. 



DISPOSE. 



Assigns output to alternate file filename (file name OUTPUT is 
not allowed; that is, alternate list output cannot be assigned to the 
terminal). If filename is omitted, the system assumes file name 
ALTRNT. While this directive is active, all input directives can be 
entered at the terminal. All list output (except error messages) is 
written to file filename and is formatted for transmission to a line 
printer. Error messages are written directly to the terminal. 

Disposes the alternate list file (specified in the OUTPUT 
directive) to the print queue. Output will be printed at the 
central site line printer. All subsequent list output resumes on 
the original output file specified on the DSDI command. 



Refer to File Manipulation and Control Directives earlier in this section for additional 
information concerning use of these directives. 
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Terminal Output Directives 

The following directives produce output formatted for listing at an interactive terminal. 

C — Dump Memory in Instruction Parcel Format 

The C directive causes the specified locations of central memory or extended memory to be 
dumped in four groups of five octal digits (one word per line) with 6-bit display code 
character equivalents. No pagination is processed for terminal output. The CM, EC, and 
UEC directives (refer to Central Memory/Extended Memory Dump Directives earlier in this 
section) determine the type of memory to be dumped; default is central memory. The RA or 
RAC directive (refer to Central Memory/Extended Memory Dump Directives earlier in this 
section) must be entered to dump relative addresses; default is absolute addressing. 

Format: 

C , f wa , lwa . 

Parameter Description 

fwa First word address to be dumped (mandatory). 

lwa Last word address, plus one location, to be dumped. If omitted, fwa+1 is 

assumed by default. 

Figure 6-1 shows the terminal output produced by the C directive. 



? C, 6230, 6240. 






0006230 34240 10100 


00012 


50036 1TAA AU 3 


0006231 00764 70000 


00000 


10113 * AAK 


0006232 04154 70000 


00000 


10113 DM* AAK 


0006233 00004 67446 


74000 


10005 - - A E 


0006234 05153 05700 


00000 


00000 EMX. 


0006235 00000 00000 


00000 


00000 


0006236 00000 00000 


00000 


00000 


0006237 00000 00005 


05111 


14422 EEII9R 



Figure 6-1. C Directive Output 



6-54 NOS Version 2 Analysis Handbook 60459300 U 



Interactive Use of DSDI 



CP — Dump Active Control Point Areas 

The CP directive causes the job sequence name and control point area address for each 
control point to be dumped. 

Format: 

CP. 

Figure 6-2 shows the terminal output produced by the CP directive. 



CP 01 


CP 02 


CP 03 


IAF 


AALT 


NAM 


0200 


0400 


0600 


CP 11 


CP 12 


CP 13 


AMD 


AAAC 


AAAB 


2200 


2400 


2600 


CP 21 


CP 22 


CP 23 


4200 


4400 


4600 


CP 31 


CP 32 


CP 33 


MAC 


BIO 




6200 


6400 


6600 



CP 04 CP 05 CP 06 CP 07 CP 10 

AAKW AAAG AAAF AAAE 
1000 1200 1400 1600 2000 

CP 14 CP 15 CP 16 CP 17 CP 20 

AALN AALU 

3000 3200 3400 3600 4000 

CP 24 CP 25 CP 26 CP 27 CP 30 

RBF 
5000 5200 5400 5600 6000 

CP 34-*— Control Point Number 

SYS «*— Job Sequence Name at Control Point 

7000 -*— Control Point Area Address 



Figure 6-2. CP Directive Output 
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D — Dump Memory in Byte Format 

The D directive causes specified locations of central memory or extended memory to be 
dumped in five groups of four octal digits (one word per line) with 6-bit display code 
character equivalents. No pagination is processed for terminal output. The CM, EC, and 
UEC directives (refer to Central Memory/Extended Memory Dump Directives earlier in this 
section) determine the type of memory to be dumped; default is central memory. The RA or 
RAC directive (refer to Central Memory/Extended Memory Dump Directives earlier in this 
section) must be entered to dump relative addresses; default is absolute addressing. 

Format: 

D, fwa, lwa. 

Parameter Description 

fwa First word address to be dumped (mandatory). 

lwa Last word address, plus one location, to be dumped. If omitted, fwa+1 is 

assumed by default. 

Figure 6-3 shows the terminal output produced by the D directive. 



? D, 6230, 6240. 








0006230 3424 0101 


0000 


0125 0036 1TAA 


AU 3 


0006231 0076 4700 


0000 


0001 0113 * 


AAK 


0006232 0415 4700 


0000 


0001 0113 DM* 


AAK 


0006233 0000 4674 


4674 


0001 0005 


A E 


0006234 0515 3057 


0000 


0000 0000 EMX. 




0006235 0000 0000 


0000 


0000 0000 




0006236 0000 0000 


0000 


0000 0000 




0006237 0000 0000 


0505 


1111 4422 EEII9R 



Figure 6-3. D Directive Output 



6-56 NOS Version 2 Analysis Handbook 60459300 U 



Interactive Use of DSDI 



PP — Dump PP Communication Areas 

The PP directive causes the PP number, executing program name, control point assignment, 
and input register address for each PP communication area to be dumped. 

Format: 
pp. 
Figure 6-4 shows the terminal output produced by the PP directive. 



PP Number 
Program in Execution I Control Point Assignment 



PPOO PP01 PP02 PP03 PP04 

HTR-34 DSD-34 QAC-16 

7200 7210 7220 7230 



\ 1 / 

4 \PP05 / F 



PP06 PP07 PP10 

1R0-05 1SJ-34 1MT-31 

7240 7250 7260 7270 7300 



PP11 

QAC-14 

7310 



PP20 PP21 PP22 PP23 
PIP-03 CP0-34 QAC-02 



PP24 PP25 
110-32 



7320 7330 

PPOO 

7440 



7340 



7350 7360 




PP30 PP31 

1MA-01 

L 7400 7410 7420 7430 



Figure 6-4. PP Directive Output 
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Q — Dump PP Memory in Line Format 

The Q directive causes the specified locations of PP memory to be dumped in line format. 
Each line contains 8 bytes (PP words) with 6-bit display code character equivalents. 
Repetitive lines are suppressed and zero bytes are represented by hyphens ( — ). 

Format: 

Q,n, fwa, lwa. 



Parameter Description 



n 

fwa 

lwa 



Number of PP to be dumped. 

First word address to be dumped. 

Last word address, plus one location, to be dumped. 



NOTE 



fwa and lwa are automatically adjusted so that the dump limits fall within a multiple of 10 8 
words. 



This format is valid only for terminal output. If attempted from a job of batch origin or while 
an alternate list file is active, the fwa and lwa parameter will be interpreted as PP numbers. 

Figure 6-5 shows the terminal output produced by the Q directive. 



? Q, 


5,0,100 


. 














0000 


0003 


2020 


3340 





0614 





4334 


0117 


0010 


0064 


0001 


7772 


0100 


0006 


1073 


1401 


6072 


0020 


2250 


3225 





0027 


0012 


4402 


5747 


5751 


0030 


0011 


7646 





0001 


0141 


0600 








0040 


1501 


1116 


2014 


0074 


0203 











0050 


3404 


2330 


0035 


6213 


1707 





4000 


6675 


0060 





4521 





6101 


0001 


0153 


0001 


0532 


0070 


0001 


0100 


1000 


0003 


6000 


6250 


6251 


6252 



CPPo5 FL 81A0 
A A FH LA 
R/ZU W J93.*.( 

I - AA6F 
MAINPL BC 
1DSX 2 KOG 5 



+Q 



A AAS AEZ 



AA H C 



/ ( ) 



Figure 6-5. Q Directive Output 
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QOA, QOD, QXA, QXD — Dump 16-Bit PP Memory in Line Format 

These four directives are valid on CYBER 180-class machines only. Each directive prints 
specified locations of 16-bit PP memory in line format. Each line contains eight PP words in 
octal or hexadecimal with 6-bit display code or 7-bit ASCII code character representations. 
Repetitive lines are suppressed and zero bytes appear as hyphens ( — ). 

Numeric Character 
Directive Format Representation Representation ^__ 



QOA,n,fwa,lwa,R. Octal 7-bit ASCII code 

QOD,n,fwa,lwa,R. Octal 6-bit display code 

QXA,n,fwa,lwa,R. Hexadecimal 7-bit ASCII code 

QXD,n,fwa,lwa,R. Hexadecimal 6-bit display code 



Parameter Description 



n Number of PP to be printed. 

fwa First word address to be printed. 

lwa Last word address, plus one location, to be printed. 

R If specified, the R register is printed. 

This directive format is valid only for terminal output. If it is used in a job of batch origin 
or while an alternate list file is active, DSDI interprets the fwa and lwa parameters as PP 
numbers. 
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Example of DSDI Terminal Use 

This example illustrates how DSDI might be used following a system malfunction to analyze 
portions of the EDD file from an interactive terminal. It is assumed that an EDD file was 
created during normal system recovery procedures. Vertical spacing has been expanded to 
permit commentary. The example begins after the login sequence has been completed. 



batch 
RFL,0. 

/ label, dump, vsn=dump, lb=kl, f =s,mt,d=800 



/get,altdir 

/dsdi . 

ENTER DIRECTIVES 



? output ,altout. 



? read,altdir. 



dispose. 



EXPRESS DUMP COMPLETE (FL USED 

xxxxxxB) 

/ 



Enter Batch subsystem. 

The LABEL command is entered to assign 
the EDD dump tape to this job. Use of the 
vsn parameter allows the job to be rolled 
out while the tape is mounted and 
assigned. 

Retrieve alternate directives file ALTDIR 
(refer to the example in figure 6-6). 

Calls DSDI, which copies EDD tape to a 
random mass storage file. 

Enter terminal output directives (refer to 
Terminal Output Directives earlier in this 
section) to list any portion of the EDD file 
at the terminal. DSDI issues the prompt 
(?) when it is ready to accept a new 
directive. 

List output produced by subsequent 
directives is written to local file ALTOUT. 
This allows entry of directives that 
produce line printer formatted output. 

All input directives in alternate directives 
file ALTDIR are read and processed. List 
output is written to local file ALTOUT. 
DSDI does not request terminal input until 
the last directive on ALTDD3 is processed. 

Dispose local file ALTOUT to the print 
queue for listing at the central site line 
printer. Output produced by subsequent 
directives is listed at the terminal. 

DSDI is terminated by entering a carriage 
return in response to the ? prompt. 



In summary, the following operations were performed by DSDI. First, small areas of the 
dump file were fisted at the terminal for preliminary examination. This was done both to 
analyze the cause and effect of the system failure, as well as determine the extent of line 
printer listings required. An appropriate comment may be placed in the list file subtitle at 
this time via the *.ccc...ccc directive. 
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Next, directives were entered to generate the necessary line printer listings. These listings 
are generally extensive, or contain specially formatted output that cannot be listed at the 
terminal. Thus, output was written to an alternate list file named ALTOUT. 

After all necessary directives had been entered from the terminal, an alternate directives 
file (ALTDIR) was read. ALTDIR is a permanent file containing input directives necessary 
to obtain a printer listing of specific areas in the dump file that are frequently examined 
following a system failure (for example, CMR tables and buffers, PP memory, and so forth). 
Figure 6-6 illustrates a typical alternate directives file. Comments describing areas of the 
dump file to be listed appear, along with the directive, in the title line of the output listing. 5 

When DSDI finished processing the last directive in file ALTDIR, it again issued the ? 
prompt to the terminal requesting further directive input from the keyboard. At this time, 
the DISPOSE directive was entered causing file ALTOUT to be printed at the central site 
line printer. Refer to Printer Output Listing Examples later in this section for examples of 
printer output listings. 



DUMP 

LC.LOW CENTRAL MEMORY POINTERS 

PP.PP COMMUNICATION AREA 

CPO,H. 

EJOFF. 

EJ. 

CP. CONTROL POINT AREAS 

CPO , XTAF . 

DP.DAYFILE BUFFER POINTERS 

EJ. 

EST . EQUIPMENT STATUS TABLE 

FNT. SYSTEM FILE NAME TABLE 

EJ. 

MST.MASS STORAGE TABLES 

JC.JOB CONTROL PARAMETERS 

CP, 3 0/T. SYSTEM CONTROL POINT AREA 

ACCOUNT. ACCOUNT FILE BUFFER 

ERRLOG. ERROR LOG BUFFER 

EJON. 

AP. ACTIVE PPS 



Figure 6-6- Sample Alternate Directives File 



5. All records in an alternate directives file must be in text format: the first word in each record contains only the record name. 
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Printer Output Listing Examples 

The listings illustrated in this section are samples of the line printer output listings 
produced by several of the input directives described under Input Directives earlier in this 
section. 

Each page of output listings begins with two header lines: a title line and a subtitle line. 
The header lines are formatted as follows. 

RA = current input directive DUMP nn DSDI yy/mm/dd. hh.mm.ss. PAGE n 

0000000 dump type hh.mm.ss. yy/mm/dd. CDC NETWORK OPERATING SYSTEM. NOS 2 comments 



Header 



Description 



RA=0000000 



current input directive 



DUMPnn 



yy/mm/dd. hh.mm.ss. 



dump type 



h.mm.ss. yy/mm/dd. 



comments 



Indicates absolute addressing is in effect. If relative 
addresses were being dumped (RA or RAC directive 
entered), a nonzero reference address would appear in this 
field. 

Input directive currently being processed, including 
comments (50-character field). 

Reflects the EDD tape number currently being used (nn is 
a 2-digit dump identifier assigned during EDD). 

This field reflects the date and time when DSDI was 
executed. 

Indicates type of memory currently being dumped (central 
memory, extended memory, or a PP number). If the AP 
directive is processed, the PP number is followed by the 
name of the program currently being dumped. 

If the CP or PCP directive is processed, CP or PCP is 
displayed, followed by the CP/PCP number, followed by CM 
or EM. If the EJT, EST, FNT, MST or QFT directive is 
processed, the table name and current entry ordinal is 
displayed. 

Time of day, date, system title line, and system version 
name taken from CMR. 



Up to 36 characters of comments specified on a 
input directive. 



.ccc.ccc 
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Example 1: 

Figure 6-7 illustrates the printer output listing produced by the PP directive (dump PP 
communication areas). 



O0O000O 



PP. 
CH 



PPOO HT* 
CP3* 



owr 01 

14.S2.11. £2/01/06. CK HEIKOW OPERATING SYSTEM. 



152* 223* 0000 0000 0000 

0000 0001 0000 0003 5570 

OT01 1501 0000 0000 0007 

0000 OOOOOOOO 000* 0S6S 

0000 0000 0000 0000 0000 

0009 0000 0000 0000 0000 

00O0 0000 0000 0000 0000 

0000 OOOOOOOO OOOOOOOO 



PrOA J T A tt in E*«CUtlOa 

Control Folat AMtywac 
Chranel Ae«i&an«at 




QJlC 

UTEH 

CP16 



CPOO 



1SJ 

l»AH 

CP3* 



CPOO 



PPZO PI* 



2101 0336 0000 0000 0123 SAC, 

1077 0000 OO00 OOOB 373* « 
0006 0001 MOO 0001 0000 F A- 
0000 0002 0300 0000 0000 8C 

oooo oooo oooo moo oooo 

0013 OOOO 1765 0000 2263 K 
0301 6*00 0000 OOOO 0000 t» 
0330 OOOO 0000 OOOO 0123 CX 

OOOO 0000 0000 OOOO 7350 

oooo oooo oooo oooo oooo 
oooo oooo oooo oooo oooo 

0000 0000 0235 0022 0001 

oooo oooo oooo oooo oooo 

*CHZ OOOO 3302 0002 1500 
0391 6*00 0000 OOOO OBOO 
0330 OOOO OOOO OOOO 0333 

3*23 123* 0003 OOOO OOOO 

1033 0001 6*72 0305 1073 

OOOO 0001 6*72 0305 OOOO 

OOOO 0002 0237 0003 0007 

OOOO OOOOOOOO OOOO OOOO 

021* 4400 OOOO OOOOOOOO 

0301 6(00 OOOO OOOOOOOO 

0330 OOOO OOOO OOOO 0333 

OOOO OOOO OOOO OOOO 7370 

OOOO OOOO OOOO OOOO oooo 

oooo OOOO oooo oooo oooo 

OOOO 0002 0235 000* 001* 
OOOO OOOO OOOOOOOO oooo 
6011 0003 5031 0003 3432 
072* OOOO 2127 1031 1200 
OOOO 0000 0002 1030 1020 

2011 2003 OOOO OOOO 0136 
OOOO OOOO OOOO OOOO OBOO 

CPOS 0311 1703 OOOO 0002 0331 

CMS OOOO oooo oooo oooo oooo 

1130 6700 4017 1701 037* 
0100 6202 0200 «1S5 0363 
0100 «022 309* 1201 3101 
3*06 1*11 320* 0502 1*12 



AS 
C*1 
A 



Hunt tor function- 



CO 



1SJ1 c 

M A? CEH 
A? CE 
OB* £6 



PKE 1*0 
- P10W 
CP05 



im 

LOAM 
CP3I 



CA 

ex 



CO 



5i tn tn 

ST 4HHTJ 

BHXHP 



CIOC SCI 

U OOAE 

A BO C 
A HNAtA 
1FLI9EBU 



MM 62/01/20. 16.22.05. 



0*23 0*3* OOOO OOOO OOOO »S*1 

OOOO oooo oooo oooo oooo 

3*0* 1*3* 0010 004* 01*2 mi H M? 

oooo aaoo oooo oooo oooo 

OOOO OOOO 1401 0613 5*00 LAFK- 

553* 3*57 3737 5733 3357 11.44.00. 

5543 3550 333* 5033 4157 32/01 «I6. 

00*0 0000 0000 0000 0000 5 

OOOO OOOO OOOO OOOO 7*30 X 

oDOOoooo oooo oooooooo 
oooo oooo oooo oooo oooo 

0000 0002 023S 0022 0001 882 R A 

oooooooo oooo oooo oooo 

0004 OOOO 331* OOOO 7325 D OL U 
072* OOOO 2127 1031 1200 6T «UHYJ 
OOOO OOOO 0002 1030 1020 BHXHP 

3*22 1705 OOOO OOOO OOOO 1K0E 

2045 04O0 OOOO 0001 5400 P8e A- 

015* 0011 ***0 OOOO 0*00 A* WS » 

4000 OOOO 050* 2600 OOOO 5 EOV 
OBOO OOOO OOOO OOOO oooo 

0003 OOOO 1776 OOOO 2777 C H 
0301 6*00 OOOO OOOO OOOO CA 

OOOO OOOO 1*01 0620 3235 LAFP42 

3*15 2*31 3170 OOOO OOOO 1HTTY 
1055 0001 4472 0230 1073 II A? BXH 
OOOO 0001 4*72 0230 OOOO A? OX 

0020 oooo can oooo oooo f 

oooo oooo oooo oooo oooo 

3*41 4033 3635 5639 1116 165032, I* 
5700 OOOO 2100 3645 OTOO . « 3»* 
354? 3*00 2000 33*5 5*15 2*1 P 0«« 

2101 035* OOOO OOOO 0216 SAC- ON 

1077 OOOO 0003 0003 3734 N C C41 

0004 0002 4476 0152 OOOO t » A) 
OOOO OOOO 0237 000* 0010 B* t> H 

oooo am oooo oooooooo 

O013 OOOO *126 0000 4*26 K 
0724 OOOO 2127 1031 1200 6T 
OOOO OOOO 0002 1030 1020 

0320 0434 OOOO OOOO 0225 CPU 

1055 OOOO OOOO OOOO WOO H 
OOOO 0004 6123 0131 OBOO » SAY 

OOOO 0005 0424 0021 0022 EM » * 

OOOO oooo oooo oooo oooo 

0777 1777 3777 0100 7100 « 4 A 
2OO0 0045 6001 3003 1013 P « AXCIBC 
0770 1401 3411 3412 3077 « LA1I1JX 



QA£ 

urE* 

CP14 



L»AH 
CP3* 



Hi 9V 
•JIHTJ 
BHXHP 

Btl 



Figure 6-7. Sample PP Directive Output 
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Example 2: 



Figure 6-8 illustrates the printer output listing produced by the AP directive (dump analysis 
of PP and PP memory in line format). 



u • 


U.I. 


DOM? 01 


Wl 02/01/20. 14.22.09. 


PACE 3 


oaooooo pros I6.52.ii- S2/01/O6. esc hetwoux orwmie ststci. 


■OS 2 






4MLYSIS OP PF03 












W03 0000 0000 0*00 0000 "30 


X 


IA8T HAIV HOCKM LOADED - 






0000 OOOO 0000 OOOO 0000 




LAST OmLAt UMDED - SHE 






CPOO 0000 0000 OOOO 0000 0000 




last mass siouce mm - an 






OOOO 0002 0235 0022 0001 


Kill 










0000 OOOO 0009 0000 OOOO 












00*4 0008 3314 OOOO »*25 


OL D 










0724 OOOO 2127 1031 1200 CT 


q»H£J 










0000 0000 0002 1030 1020 


1EXHP 










nsuarr rani nnts iw con carsnms 




OrtKAIIHC (ECIST2BS 






turn loc cAixiR am uc actual txrEcreo 




f K 


A 




mi 0143 2205 «* 55 4004 




3EF0U 1»U 00130 00076 004000 


0*4135 




DRI 0432 2341 FL 34 0021 




ARES IDLE 00133 00064 107700 


9*7371 




UK 0471 1477 OK 70 0001 0001 










3W 030* 0355 W 71 0100 0100 




OFT tUFFR 1 00000 00170 000140 


000010 




US 0333 0370 TH 72 1000 1000 




pjt wrreit 2 03000 07410 005004 


000009 




UBS 0554 1T40 It 73 0003 0003 










OS 0541 0*13 Cf 74 4200 










1* 75 7230 










OA 74 7231 










HA 77 7232 










k-CtG 00010000 00000000 


**• Momc •*» 






m Httnn 










0000 


0214 2210 2175 2414 0004 0001 4473 0315 


•othq nrtia 


ooio 


, 2120 


0» 


0020 


0045 0030 002J — 4000 


II 5 


0030 


4009 0301 


5 CA 


SOW 


0002 5304 0203 0053 3101 0006 


ID K1MF 


0050 


— — 7430 400» 0021 0312 


XSD QCJ 


0060 




OL 


0070 


0001 010* 1000 0003 6200 7230 7231 7232 


AA H C XXI 


•100 


0002 0343 0411 


1 COM 


0110 


. 00*4 2711 ■ 1006 0621 1002 


PHI NFFQ2S 


0120 


0704 2000 1701 0574 3010 2200 0177 0334 


CD* OtE XW A <3 


013* 


1457 4010 3010 3374 0513 1425 0327 2000 


L. MOW KLOOF 


0140 


1720 0474 3074 4010 3010 1301 0546 3074 


OPT X BXBKAE-X 


0150 


1625 6010 2411 3013 3455 3014 343* 3076 


iu mm XLi.x 


01*0 


4010 1400 0100 2205 0443 3410 3074 4210 


■L A «SM1H( H 


0170 


1427 3210 0644 0312 0711 3011 1277 5100 


uraaFfcicixij c 


0200 


0510 0010 3010 1013 0731 1005 1455 4010 


EH lUmiiTHH, ■ 


0210 


3010 3111 0572 2005 1447 6370 0111 2005 


xnriE rl* Aire 


0230 


1447 2410 4010 3014 0445 1720 0476 1502 


i«v« nuwrr n 


0230 


3500 0445 1474 6210 0356 2001 2551 6173 


2 F L BC.HUK 


024* 






0250 


2000 1704 0574 3075 4050 3050 0471 3077 


tmi lUtt x 


0200 


4173 0020 3051 1340 1004 3474 3574 3374 


pxaso-i 2 


0270 


3350 1004 0200 0321 0115 0005 2000 0034 


o/m CQAH tr 3 


0300 


3412 2000 1505 3413 1473 0200 0143 0324 


U? IE17X 1 A Of 


0310 


3311 1014 3112 4113 2120 1400 0200 0143 


OlftLXJ KOPL 3 A 


0320 


tlOC 0474 5400 0302 1043 5400 0277 3074 


1D-CK-I1 


0330 


6010 3710 0543 3076 *210 3014 0502 3015 


•west HXLEHH 


03*0 


3415 5400 0314 3011 1377 0542 3015 1702 


m- euro; E7mc» 


0350 


3403 3076 4004 0200 0504 1440 5500 0110 


1CX •» EFL5 AH 


0360 


4003 3414 5003 0041 3417 3003 0200 0553 


5CW/C AlOIC* 15 


0370 


0727 3407 5300 0104 0504 3407 4003 3406 


OOC* ATO1C5CIF 


0400 


3014 4403 3017 5403 0001 2000 0500 3503 


23IKXO-C AF E 2C 


0410 


5715 0003 0543 0200 0541 0100 0315 2000 


.» CE4* E A CKF 


0420 


2725 0302 3071 2142 0420 3401 1453 4173 


WVCIX S7W1AU 


0439 


7742 0100 2341 5*00 0*57 1701 3402 1063 


A S6- D.OAUS 


0M0 


3412 1217 nil 0410 3402 4002 0175 3402 


MJOIIMSlStt 3S 


04 SO 


5200 0437 3411 1404 3401 3077 4301 2572 


) o.iitriAi au 


•460 


1452 0200 0143 3014 0444 2001 2225 4173 


D> a annua 


0470 


774* 1477 0200 0321 5000 0*7 1 5415 0006 


L > W -H F 


O5O0 


0115 0007 1444 4170 0100 9100 0355 2000 


AM OL A A C t 


0510 


7444 3105 4010 3014 1003 1606 4170 0102 


YE HOJICtO; Al 


0520 


3000 0110 1237 0554 5000 1104 5200 0107 


I AHJ4F.,/ AD> AC 


0530 


0*29 3500 0107 3413 1441 1412 1473 0200 


OF ACKL41JL ■ 


05*0 


0143 3011 1014 3112 4113 0531 0340 


A XTH.IJ HCC5 


0550 


0101 1056 OMO 0370 0314 0100 1740 0334 


» «,* C CU 05C1 


0560 


0100 0415 1400 3413 4471 0200 0773 0370 


A BHL IK9 ( G C 


0571 


5400 0606 4771 0705 3107 3300 0624 0403 


»ff» es»e* rac 


0*00 


02*0 0643 1404 0200 0744 7104 2114 0532 


IfUtC- rOtEZ 


0610 


500* 0553 0335 5400 04*0 1043 5400 0433 


/ Esc2- Ti» » ro 


0620 


4771 0705 3107 2300 0342 1403 0200 0443 


* cores C70C3 t 


0430 


4071 0403 200* 1135 0200 07*4 7304 


J OCT 120 c- r 


0640 


1131 0515 5000 0556 4406 0444 7544 3410 


itau t, m -iv 


0450 


1412 0200 0744 1401 7104 0013 0525 3013 


U> O-LA F KEUXH 


0640 


0524 0110 0402 3076 4010 3010 0574 


ran fbi tat 


0670 


3077 6204 1455 0200 0163 3714 4471 3107 


X DL 1 A 4L5 TC 



Figure 6-8. Sample AP Directive Output 
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Printer Output Listing Examples 



Example 3: 

Figure 6-9 illustrates the printer output listing produced by the CP directive (dump active 
control points). The default list options (XTAF) are used to dump the control point. This 
example consists of six pages. Also, notice that the columns cross page boundaries; that is, 
the left column is read continuously, from the top of the second page to the middle of the 
fourth page. The sequence then continues at the top of the right column on the second page. 



«* ' CP,2. tW «0 OSM 

0000000 CM 22.15.04. S1/V&/B2. COC KIWK OPEMTINS S«II£B. 


W/Ofr/02. 22.34.17. FUE 
HOS 2 


1 


o*oo - cwnmi. point 02 






«KE EXCHANGE MOUSE 






r 3335? a 22ST7 90 (MD-0000 0000 0000 0002 2575 00 
M 120300 « 1 01 3 <M>-0000 0000 0000 0090 0000 
Ft 44400 42 21250 B2 S1053 <*2>sOO0O 0000 000O 0000 O0» T 
ill 70070000 a 1U» OS U3>=M00 OOOO OOOO 0004 3521 »2> 
HE J* 3JC70 St *5 IM><0000 000S OOOO 0005 3244 a* 
flE 45 33072 85 3154? (*5)=OO0O 0000 0000 COOJ 3273 CI 
M 400 *i 1 M 33*46 <J*)>OO0O OOOO 0000 OOOO 0000 

»7 33070 07 43515 U7)-0000 0000 OOOO MIS 3244 C2» 


(801=0000 OOOO 0090 0000 tooo 
<01>»3444 («00 OOOO 0000 OOOD 1OT 
C92>sO(OD 0520 2500 0000 0000 » CPU 
CU>»0OK OOOD OOOO OOOO 0000 
CM>-0000 OOOO 0000 0000 OOOO 
r05>-OtO0 0320 5100 OOOO 0000 » CP< 
C96>-3110 033* 3001 0003 327* CMC3M « 
<07>-OM0 00O4 0435 O20( 3715 (420HII 




10 7777 7777 7700 0000 ODOC CK»-0000 0000 OOOO 0000 OOOO 
XI 0000 OOOO OOOO OOOO OOOO <X1>*0000 OOOO 0000 OOOO OOOO 
X2 0000 OOOO OOOO 0900 0024 7 <X2)*O90O OOOO 0000 0900 0000 
X3 OOOO 0000 OOOO OD04 3521 »2i <X3)<MOOO 0150 0000 0000 0000 H U 

h oooo ooao oooe 0005 1243 a* uo=o*oo 0321 ttx 220s oso? » <a ate* 

X5 OOOO 0000 0000 0005 1273 CI U5X00O OOOO 0000 OOOO 0000 
16 2203 WOO 0000 0000 OOOO Kt UA 1=0000 OOOO OOOO OOOO 0000 
XT 0009 OOOO 0000 0003 3244 C» <m*0400 0320 1130 0530 0SO3 » mxExIC 




nUUKETE* SWMUtT 






USE* HARE NEWS SENSE SWITCHES 00 
PHHUY FILE CCL « 000000 




X LIU OptlM> 


otien tip! srot co. a oooooo 

TINE USE6 OO000O0OR CCt (3 000000 

THE REM4IN1K KJ14225S2? CCL if 00 
SU9SI3TEN i» 7770 CPU POlOttTT 0077 
cv status t semtcc cuss »n sssc 






KSSME 1 - «P«rlK 22.05.tK-.LLllK lM3105,EN,n.-3,H-N,S 
•ESS40E 2 - sniauesT «• msput 






cuntorr c<MM» - mP'<pii«.iw,isTP-vts,fST(>->ES^ic*S)0i 






LUT 04VFD.E NESSME - 22.O5.C9.NP/sm02 22.05 .0°.LUI* L003103,.£»,ei.-J,ii-N,S«|102 /1C3,S»102 /00J 




special arrtT mats 






EJC BIIKY 






025000 KOI 1355 0137 7777 0002 m» U 8 

025001 OOOO 0000 4000 0002 777* 5 1) 

025002 OOOO 0000 OOOO OOOO OOOO 

025005 0700 9000 OOOO 0000 0036 6 3 
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Express Deadstart Dump Interpreter (DSDI) 6-65 



Printer Output Listing Examples 



cf>2. 



ao 



22.is.lti. SSIBilCZ. CK NETOHK UTWWtlPlG sure* 



Mel 



tVM/02. 22.56.17. 



EeglMJtag of T List Option 



contra. Fowr «« 



CFtl SIITUS 

cm sxo-<r uim 
awat* rre «si«t» 
E**w fus 

stsemo 

sosra*> <M rollout flu* 

MUOn CMTML 



/ 



SI» 090420 5 



Seoul canon. 

cro niMin/teuu 

tfsmo 

cm sclcctiw 

Htstsrem* 

Ma cotnoLf«>is« fuss 

uses mwr, FisseRW ets 

cn atom. c«neai»a etc. 

JOB TEaamtTION OPtlM CUV 
tunc FILE anrasTftON 

tESEKXS 

C3W/1 SKTUEKT FLU 

cmKe an tp/co. tern 
jce **:ei* n»E jo™ 

ore* *ssiaae» nap mck 

MMTTK Fv/1008 FLSa 

•sen recover an 

ustoce 

fl'iooo 



avtooo - anJiow 
una ♦ nfl/woo 
fl/iooo 
zete 

•ESnVE* 

ECS M/WOOO 
CCS PI/10000 

Fwca froc/wtxtltc 



JCI1I 000-21 0176 



001 221 

000422 00030000033713026422 I COS * 

000423 

a 



CtSV OOM2o ODOO 



sasa 000427 



H> MUSE FUSS 
SEUSE SMTKHES 



*essme i «*» 



bessme 2 me* 



psnunw acaa o 
nsiMUttiaa aot* i 

laSTtLUkTIOl mord 2 

nuiMuno UOM 3 



IB1V00D4XD 

000*51 
000*32 
000(33 



auwooMSS 



ooooooo 



00 
16203023163433353353 «r/Sa102 
33333537334057334637 ttJJSJtf). 
14141116130053145333 IXIRK LOO 
363t3B6S60516S622tt 31*3.np,*L 
S43636W461636230100 =3,a-«,S 
53220321230523243547 StEOUEST • 
13475S«4112!Z0140131 » »15FIM 




mvooouo < 

una oooMi 

war 00044/ I 

IB. 000443 OfJ CO rJOODOOOOOOOOOOOO 



DEStaVO »FC» 000473 ( 

cokiax STalEMEMT uatess 
tcaMB file urnm laasx 

RESERVE* 1LMI00D476I 

MX MCPJETIC TrVCS 

nut HaansLE nea 

RU DEE** MTCH JO*S 



au pike urn 

MX SHI LMIT 

aj» fiel» uaww 
an ks not lersth 
ail life* rotate* 
Mi uaos poi«e* 

RESEMEII KLU 

hifile Passages coaai 
control sTMEicais on 

tESEI¥E» 

as MUS COBM 

aecoan aecEss aom «*c» 
mr m am. aMa 

RESERVE* 

tw> ni accwMJK* ana 

auci/2/3 MOMuieas juna 

JUK4/3 «cvau.»i«s 

reseoteo 

lEtana ouffee tow 

«W*CSS BUFFER 

lEtwfa boffer 1 

ammss aarFER « 

s»ec earn reiar flu set* 

mvui-'Of eb ft flms 

M«»/aia>=/saa= a pr elms 

S3J>/MLKSS)» E* PT FLMS 



000500 

000301 



mitt 
wnaixxattBssrrnrt c 

O0OHW2 » 




REST»rr/suF»«ES» »»• flam 

W» FILE Fl*« 

0«p= FLS10D <0 - EKIIRE ELI 

SSJ* MtMKIER BUC WORKS 

STSlia MM C*U. •»» SPCV 000306 

CO. - EFF JCW 000307 

Ctt - «« 

<a - MM 
Kscm» 

«s. - tl iCM 000310 

ta - »3 

CCL • 02 
CCL - « 

SEC «E«/lC MS FUtS M 000311 

ec3«a> cncaaiuaE fuks 
lanri (OFFER mess 
aicar scosi af» up> 

LEFT SCREE* BF« M» 

fib> ociiob/ub Fiae Laiv 00*512 



01 
ooooooaooocrtnoeooooo 



Figure 6-9. Sample CP Directive Output (Continued) 
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Printer Output listing Examples 



CP,2. 

en 



22.is.at. am/a. ck betbobk orautins srsra 



BOS 2 



nmooowT ooaoooooooooooooaooo 

net* 0D04SO 00 



wsmijLnm m 4 
d6iul«ic« now 5 

WSTULHHB «0» 6 
nOTMUTIM BOBB 7 

inn flms 

ovebflovflus stw onoo 

su wcuNunw/HninM coooi«si27i722 

c p tarn MuwHtTSM) en« oo»si oooooooiiiTtosnMOOO *w* 

K> 4CCWU.IITBBS TOW 0X452 00314S40000000000416 «»5 I 

•nj =• m ♦ IO POW 0OH3I 00003* 5 5 



btp 0/ 



4660 ACCBMJLATOR «MU D000002 

ITI • IKS BT2B 000454 025420 

mi « HI » « 001750 

besebveb 

hmu saw «cw, cm *>» ooows 0000025700 a. 

fM OD O 0O O 42 5O 

»U UXOMt BLOCK LMT ALU 000456 777777 

cobwte* »o job sief- nan tmnimmi 

•nemo sua 000457 0000 

9W JOB STEP UTMT 77777? 

9Hl KOM IT JOB STEP STMT 0009040304 

beseheo eMM OM4<o oooo 

cf nw job stef> ubii 777777 

cp Keen job step stmt oooooooot* 

tmttetltlOMMIWt FLSS fPK MOW 00 

besebve* 00 

wa aauottita unn 7777 

na mixi of hobble file OHO 

LEKL-3 tUKK TBACK OOOO 

LESEL-3 BLOtt SECTOB CO00 

ntenee 000442 ooooociiaoDOOODOoano 

BM FL FOB JOB STEP FU» 00046S 5745 4 F 4 

LAST U» FL flB7L> 0600 

•um FL FOB EMTIBE JOB 5765 

BESEBVEB 0Q0OO000 

JOB STEP BBS ECS FL ELCB 090464 0200 B 

LAST CM» ECS Ft (HFL) OOOO 

JOBPK1 ECS FL 0209 



Eonr dssicwb cam 



tun 000465 DSD1 

Fin ooo 

SCBEMJLE* STMUS 

■ccnKC n. fob bollxb < 

ECS Ft BE0BEST 
CM FL BEBBEST 

ran «B»Ttm now 00044s go 



TEMMU. HO 46M 

output BonrEi 



ttiw 

TUB 

1MB 

PFCB 000467 00 00 0000 000 



EST <BI> Of riFHLT BEMCE 

i»n f« sni »« «*f 

libit tm — iiL » of f 
libit can SICE IAPF 



laCBUCCAOMC* FLB6S 

IttSEBVEB FIR IMKB OOOO 

iancuciivE tcais camta. oooo 

.cloou. lis ntiuins — — — - 

istcom UB/CLBML ma lb2» orosi? cccaocoo o ooeoooooooo 

IIBST LXB/fiLOBU IBB LB5B 000514 BOO O OOMOOOOOOIjUOUtlU 
f«T ADM L4ST F1L EIK EKV 000515 COOO 
|CCS FL FOB BBF- CELL F*W 0000 

FL FOB 6BP* CALL OOOO 

mjhp wki conn oo 

nt of mnp oooooo 

KESERWt 0BB16 00( 10 000000000000 

carsTAwne cobbect cowr 0021 

ROLLOUT HUBBU SSCB 000517 GOOD 

corned iobsuit bespobses cmcoooooooooooo 

C0BPUTEB CP TWE LIMT CFt* COC520 J7777777777777000000 4 
LIST OF FILES IBBEX LOW 000521 0000 » 

LIST OF FOES ACBECSS 02S655 



05/06/02. 72.K.17. 



00 



MLB 

■not 000522 00400523 



O00S2S < 
■COI OW526 ooorwwoiwoooBo o ooc e 



»FFL WCESS LEVB. 

Ol BESL6EKCE TIME LBT 

•ftEMTO » 

MIT T1FC SLICE OCCBE FLU I 

CM TtHE SLICE LIBIT 

UMB/tUSniSEB M EST JSCB 00052! 

PF N EXFA.0BEB MJHL 

BBITE KKB/WUeetE* TENS 

acsonf o 

JOB ECCESS LEVEL 

BSEt ACCESS LEV VUOMT10B OOO 

JBB BCUSS UMEL LOOT 

BSE* BCCESS C«TE«BT SET 

SEFME.I FS« BMIE FOBI 000S24 

t€F»«T PUCK TTFE 

■ESCBWEB 

■CULL UTTEBHB 

BECML (SITEEIOB 

•COIL OnEBUM 

BECML CBtTEBIOB 

■ECMX CEITEBIOB 

•EMU. CMTEBIOB 

BEC6LL CBITEBIW 

BEC4U. CtltEBlOB 

BEOLL CEITEBIOB 

BK«LL CBnEtlOB 

•KLLL CUTEBIOE 

BDU CBHEBIOM 

becul CBrrranw 

KCBLL attTOIOB 

«EC«4l BEBUESTS IB-S 

EECUI. BEBUESTS V-S 

BECUL BEBUESTS lt-S 

•KILL BEBUESTS tt-S 

BECUL BEBUESTS IB-S 

KC4LL BEBUESTS T*-S 

BECUL BEBUESTS IB-S 



00 
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Express Deadstart Dump Interpreter (DSDI) 6-67 



Printer Output Listing Examples 



t»,2. 

ex 



22.1S.0l. S3I0C02 



MMFM 
UC NflWK OMMTIK S1STCT 



MS 2 



43/06/02. Z2J4.17. 



UNIT F« SIZE OF Mf 
e$ct MK UIW 

cwwtE fuw, i«» m&ex 

NO KIT fLM ffl» 

MSCtttt 

■nmc mi* 

TEMBUt. imiT noma Tin 

■oniem »»» 

«T aiuuut. or joe ttw 

fkduot riu rar eff to 



OO047D 140524172OZ500 
J 

000471 2 



oowrz 0017 



MXkOUT TDK TBW 

rar Mscnrm 

iksexWO csm 0C047J 00 

LOtOOT ffllK, EMIOC H* < 

n cMME/aaa/mdoir ok 

cm fus/cs comr 

■en- sT»tawrr u*a 

unit nc 

MFUT/acir fuws ess* mwti o 

est aniaM. oot 

FKST1*MK 4 

CtWtfNT T*»C* 

toman seen* 

0MBUP »0» (OUMT 



I KOU tEtWSIS 

4 | RCUU. Houests 
I Kcm ceaHSis 

BS» I IECAU. KMWSTS 

' tCULL ttWCSTS 

I KWLL KMUF.STS 

I SCULL HfOMSTS 

| tE<MX tHMCSTS 

• KttlL DfOfSTS 

! tfclu KOKStS 

■ NECUL KOKSTS 
t «CIU MOKSIS 
I tECJUL KMXSTS 

«1 • tCCWL KW£STS 
! BtOUi. K4UCSTS I 

■ KCMJL KHMSKI 

I rwj. Ktutsis i 

I KUU HEMESTS I 

I WCMi KOKSrS ! 

» , 4ECM.L tfCUSSTS I 

' OEOU. KEOUttIS I 




■e-s 
m-i 

NB-S 
IB-S 
«B-S 



«01 



I OOOOMOMMOOOOMOCO 

000566 1 
00054? I 

0005701 
000571 1 

oaosrei 

000573 ( 

ookk r 
ooosn< 

000574 1 
000577 OOOOOOSOOOOOOOOOOMn 




T UK t»tS<m r. 



shMC 2 Of 4. 



OMFILE FOJUTBS 



2^, j_J ♦ 

M» «»FFE» ' A Uic 0»<le> V / 



amsan ooii 7777 0000 an oow 1 

•0120274 OOOO 00*) OIK (MO 0104 «. 

00120277 0007 4200 4200 0010 ODC3 «7 7 



■ { 



00117777 



00120007 
QSI20013 
00120017 
00120023 
00120027 
00120033 



0012004? 
00120053 
00120057 



00120077 
00120103 
001 20107 



555MJ573S4C57SJ4157 
55353537334057334137 
171400SS5S3454S6SS1* 
55553557334057534157 
0H335l617D4t5005S33 
55353557334057134437 
3W3»WW1Cg»« 

UU11141300J 5145P 3 
16345333555550333334 
231434533S555554SS04 
SSJS3SS73S3757573457 
1701041114*755511511 
55353557333757374157 
55353537333757404157 
12010411160735311403 
55333357353757404257 
5SSSJS57S340S73341S? 



35232520052224112311 
1420S023163t33S55SSS 
03260514005540443756 
16205023143433155555 
15335635292205261117 
16205023163453355555 
S636561*4616M2S1636 
SS3S3SS7S34QS73364S7 
3*343336360516562214 



03553555»23»Sa)OIO0 
23163435555555565514 
16235055555355355555 
02555535525755000000 
23143433335535565514 
14205023163433333555 



17165507011114030100 
35353357334057334157 
55240122110114240055 
553533373M057S341S7 
252355M2355U170UB 
553S35S7334057334457 
S335SS5550X)3336S62S 
16205023163433355553 
S43654M461656Z31634 
16Z3SD535SSSS55553S5 
44550317152014032405 
3533355733375757363? 
33353537335757374157 
17DM41I16O75SS10211 
33333557333757404157 
SS3535S733375741H257 
17010455931715201405 
55353557334*57334137 
55353557334037334157 




14141116130055143333 
16343335333530345336 
33353357334057334437 
33355555 503433345423 

55353557to7373734S7 

23143433355555565514 
1623S05S3SS5S53SS5S5 
07141555525755001000 
23163433333555365514 
14235055535555555555 
2405045 7ODDODO0000DO 
14202500552314341333 
142050251*3433355555 



22.0J.04. svonrino* «•!)» 
22.05.06.NW$aig2 22.05.06. CC» W«I 
m 33, UW. 5K> »«tl»r 5»4 

22.os.04.ir/sin02 22.05.04. recvnus 

CS NWE 000, MtEVIOKS US BOM 000 
22.05.nj»'9«102 22.05J4JXIW (.00 
3M3,BI,tL«3,H1l,sm02 /OM^HKB 103 
22.05.0«j*>/sm02 22.05.09. 
UIK L0>310J,E»^lt"3>-ll,3«102 /103,S 
■102 /003 *U 22.04.43. 

SM02 , WOP IHOIW c«m.<ra». 

22.04.43.MS/ 22.04.43.SII1D2 , L 

<u» one >. 22UK.44.ie7 

22.04.44.51002 , UM4IK <BWl« >. 
22.04.54.KS/ 22.W.S4.SH102 , I 

OteMK OK* >. 22X4.57.K/ 

22.04.57.1*102 , IMl Ca*LETID. 



22.05.06 JT/SH102 



22J5.04.mi OH02 
22.05.04 JOVSH102 



0MII1C UMCS U WFF€R 



■SS 22.«.43.5II102 , DWP HFOOIW COfPliTM. 

22.04.43 JB/ 22.0l.43.sm02 , UWIHS OIK >. 

22.04.44.NS/ 22.C4.44.SM02 , UMHNG <»KU1 ). 



Figure 6-9. Sample CP Directive Output (Continued) 
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Printer Output Listing Examples 



CP,2. 

CM 



«U»P DO 

22.15.04. sj/06/02. etc network okmtim system 



S3/06/02. 2Z.J6.1S. 



22.<U.36.SK1CI2 , L0MJIN6 (MB >. 
22.04.57.9102 , LOW COMPLETE*. 
22.05.06.WV SH102 ,K,103 
22.OS.06. SUPERVISION GAINEO 

22.0S.06. CCP VERSION 33, lEPti. S»4, wiakt 5« 
^. _._.,.. ._-,_ 22.05.06. PREVIOUS CS N0« 000, P*EMOIS US «0»E 000 
22.05 .OP.NFVSMTtZ 22.03 .W.U.1NK L003103.F>l,ll=3,H-N,SN102 /O0S,SN102 /103 
22.05.O9.Xf/iK102 22.0S.OB.U.INIC L005103,E*,»L=J,N-».,SN102 /10J,S*102 /DOS 



22.0t.56.IS/ 
22.04.S7.HS/ 
22.05.06.KP/ai102 
22.0S.06.NP/SIM 02 

22.0S.06.KP'SN102 



(CTXCHEO FILES - 



F LUC Option 



0115 0OTF1L LO 



0320 ZZZZZCO II 



0523 ZZ2ZZC2 LO 



0326 SWOT 



0557 UST 



fur - 1116 2025 2400 0001 1700 INPUT HO 
FST - 0006 4175 (175 0002 0005 F6 6 B E 
TR6CK CM1N - 
4175 0002 

mr - i«oi 1500 oooo oooo isoo mn h 

FST - 0006 4176 4176 0004 0005 F6 6 > E 
TRACK chain - 
(176 0005 

FNT - 1725 2406 1114 0000 1S0O OUTFtt. H 
(ST - 0007 4205 4205 0001 9105 S7E7E ME 
TRACK CHUN - 
4205 0003 

F m - 3232 3232 3205 3J01 1007 Z2ZZ2C0W6 
FST - 0006 4175 4175 0001 000$ ft 6 « E 
TRACK CHAM - 
4175 0002 

PUT - 3232 5232 3203 3S00 1507 2ZZZZC2 « 
FS1 - 0006 4177 4177 0002 0307 F6 6 BCS 
TRACK CHAM - 
4177 0002 

FNT - 1725 2420 2524 0000 1200 OUTPUT J 
FST - 0010 6742 6742 0001 OOOS H 7 7 A F. 
TRACK CHAIN - 
6742 0001 

m - 1622 0634 OOOO 0000 1500 WF1 H 
FST - 0007 42T0 4210 0002 0705 e7W7W BGE 
TMCK CMktM - 
4210 0003 

MB - 1622 06JS 0000 0000 1500 NRF2 B 
FST - 0006 4200 4200 0001 0705 F7 7 ASE 
TRACK CHAIN - 
4200 0003 

FHT - 1411 2324 OOOO OOOO 1200 LIFT J 
FST - BOW 7052 7052 0001 0005 » i > * E 
TRACK CHAIN - 
7052 0001 



0342 ZZIIZFP m MAT - 3232 3232 3220 2000 1200 ZZZZZPP J 



u * er,2. "^ gu 

OOOOOOO Ot 22.15.04. (3/06/02. CW N£TW«K OPERATINS SYSTEN 

FST - 0010 7053 TOS3 0001 0005 « S S A E 

TMCK own* - 

7053 0001 

0345 22ZZMCJ m Mr - 3232 3232 0615 0200 1200 2ZZZM4F J 
FST - 0010 7054 7054 0001 OOOS H ' > 4 C 

tuck cam - 

7054 0001 

0350 ZZZZZM 10 Fur - 3232 3232 3204 1600 ISOO 22Z2ZDN H 
FST - 0007 4216 4216 0022 0703 C7KTK ««C 
TUCK own - 
4216 0022 



FUT oooo oooo oooo oooo cooo 

EST 7700 6210 0013 1377 0421 1277 » K t&) 



tut oooo oooo oooo oooo oooo 

EST 7700 42T0 0013 1377 0421 1277 IKW 



PUT OOOO 0000 OOOO OOOO OOOO 

EST 7702 6210 0013 1377 0421 1302 H KK WWL8 



FUT OOOO OOOO OOOO OOOO OOOO 

EST 7700 6210 0013 1377 0421 1277 » Ot MJ 



FUT OOOO OOOO OOOO OOOO OOOO 

EST 770B 6210 0013 1377 0421 1277 IKHI 



FUT 0000 0000 0700 0000 0000 6 

EST 770* 4210 3226 1377 0412 1305 7MZW MICE 



FUT OOOO OOOO OOOO oooo oooo 

1ST 7702 6210 0013 1377 0421 1302 K Xk I 



Fin oooo oooo oooo oooo oooo 

EST 770D 6210 0013 1377 0421 1277 « K MJ 



FUT OOOO OOOO 0700 OOOO OOOO 6 

EST 7704 4210 3226 1377 0412 1305 7WYK MKE 



FUT OOOO OOOO 0700 OOOO OOOO 



BSBJ tSIOtm. 22.36.T*. PMC 6 

■OS 2 

EST 7704 4210 3226 1377 0412 1305 7m»K MKE 



FUT OOOO OOOO 0700 oooo oooo e 

EST 7704 4210 3226 1377 0412 1305 TtHW MKE 



FUT OOOO OOOO OOOO OOOO OOOO 

EST 7702 4210 0013 «377 0421 1302 « KK 1 



Figure 6-9. Sample CP Directive Output 
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Express Deadstart Dump Interpreter (DSDI) 6-69 



Printer Output Listing Examples 



Example 4: 



Figure 6-10 illustrates the printer output listing produced by the MST directive (dump mass 
storage/track reservation table). The MST is listed in two columns. The left column is read 
from top to bottom, perhaps across page boundaries, and continues at the top of the right 
column. The track reservation table is listed in single column following the MST. 



JBT.13. 

at 



OT.S2.49. 6W0V06. 



aunt 33 

CSC HEnCKK OHMATMC SISTEK 



S6/0S/O4. 10.0 1. 24. 



mumon o» - m»ss rouge tuu 

MMKK OF TUCKS TKS. 014170 3ISO 

n wmuxx / cams <x 

mraan 

rUSt MAIL TUCK TO 
KK4J AVAILABLE ttACKS 

cti/K raut/cr ike cw *oa 014171 



h scs cum rasr TUCK 
Mncr access rai otr 
rust tuck iqnr 
uumniH statksks 

; IDLE 



FLM/KST LDK W OK HKL 01*171 0001 01 20 UT A! V 

im/m amin our 000111612? 

w ntcx/crwrx nrmucKs 00 

MUST TUCK UPT HO, 01(173 4042 J7S SI $ 

label »««f^ 4000 

FUST TUCK mm 4041 

Mi CATAI0C TUCKS 0040 

n«*r TUCK HI oooo 

mair ok net iuic no. aitm mjowooooooo mr a 

BmCSMMU 01 

■met a. max uua/vms. oc 

■el am mount! hbv o 

■h an HULTiinT m o 

•sot an nius race ncl »i« 17$ owooooooooooo 

COS UL TKX/BK* US MASKS 577777 

rues urn bat wdex moo. oi4i7» iooi mou 40 

JI-BT 7UC •/• SECT0* Unit 0343 

041100 
01 
034) 
K¥CL 0)417? 0000 

0000000000000 

000 

ISO. 01420ft 00000000000000000000 
I2GL 014201 
MIL 014202 O 

00 



ntxro index 

SBCT0R LIBIT 

tuck to be ruorEB 



ustttEn max rues 



ws/«via nstr. . ■ 

SUSVECr/tESTA. «nvrrk 

OUTSTABMie KqoiSIS 



cumskt msinoH 
bot bet K»rno« 

2 

1 
«HfOeniM rues 
■mi m fml esc 
*nrr> oto w msr wit 
Device ruus 

WKWt TIPS - 3 KIT r«ut 

CfV TtR « 3 SIT VAL1K 

M r«TH TtfE - 3 kit v«me 



4000 



NU. 014203 0000 

0000 



alsom** mi 



(MIT KESEKVE COSKT BJt 

OMUL TOT MIT KES 0HJKT5 
FT IKTOIOCK / C0OI1S 



0000 



00 



01 



0000 



mow uacx - 1 

an- nemsam table tuck 

FAMILY. TDIX STAT/ACT COOK 0000 

LOCAL STATUS FLAGS SILL 014203 000000 

EBBS* STATUS 00 

auan is 3341 

cnottaT user, conn Mr oooo 

UEXT EST OCDIKAL IB CHAM. 000 

|»«*;jH SXAT0S 1 

KBDTJ III HtOC/MKL BQ BOLL 014204 O 

KE3EBVE0 

0KICUI4L B0. OF OUTS - 1 

COURT K. Or OBITS - 1 

SQVMHEKT IUDI LIST 0000000000000001 

LOCAL USTAL AEEA ISLL 014207 00000000000000000090 

KESUIieO TILL 014210 00000000000000 

lUOJTtt 021437 

rasr ruum tbusbolo 014211 0001 

JISTUCI ACTIVITT auaiOLB 0313 

UK SPACE IUKESMLD 0146 

tECDUKED BOSK TKE9HU 0030 

MHWOVUn EUtOK MBSKOLtl 0001 

vempih«tioh fAiuite en 014212 oooo 



0000 



UMtECCVEKCB EMtOR COWT 
USEKVEB 

mat mtk/tue 

lESEKrtp FW COC 

tor WITE FLAC 

IF DREKLOCK SITHASIC 

KESCUU 



014213 OCODOOOO 



000000000000 



tax 014214 00000000 



01*213 00000000000000000000 
014217 OOOOOOOOOOOOOOOOOOOO 



TUCK MSBtntTon IAKU 



021437 

021440 40004 

021441 40010 
021*42 40014 
021443 *O»20 



4001 4002 4003 4004 4017 
4003 4004 4007 4010 0217 
4011 4012 4013 4011 0017 
4013 4014 4017 4020 0217 
4021 4022 4023 4024 0117 



■ 1111 3A3BSC3BS0 

■ 1 1111 1E3T5C3U0 

' 1111 3I3J3X3L 

• i — mi Mstccmo 

• -i— mi 



KTU OntUal 



SCACttS tics 



Figure 6-10. Sample MST Directive Output 
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Printer Output Listing Examples 



Example 5: 

Figure 6-11 illustrates the printer output listing produced by the C, D, and E memory dump 
directives (instruction parcel, byte, and word format, respectively). The same portions of 
central memory are dumped in each format. Auto page eject has been disabled using the 
EJOFF directive to allow listing the output from all three memory dump directives on one 
page. 



c,so,iio. c - f«a»T mmp. WW oi 

CM 16.S2.11. 82/01/06. CK IKTWCK OPEMTMS SYSTOI. 



0O000SO 00000 00000 00000 00000 

0000052 DOOM 00000 00000 O7240 5 

0300053 30764 01030 100S7 43001 X KBK XA 

0000054 u-ni 44234 12147 30200 kltul b 

0000055 01633 01401 00034 177*1 * XL* C* 

0000056 OOOOO ODOOO DOODO 07164 
1)000057 7777S 12230 00320 00000 «t* Z 
OOQ 6 00751 10000 OD0D0 00000 1 



0000061 77770 00000 00000 00000 

0000062 OOOOO 00000 01065 34137 
000006? OOOOO 00000 OOOOO 00000 
00000*4 OOOOO OOOOO OOOOO 51426 
000006! 00042 71100 OOOOO OOOOO 
0000066 OOOOO OOOOO OOOOO OOOOO 

0000070 00000 OJJ00 24040 40000 

0000071 74500 00122 250D0 07421 



02/01/20. 16.22.27. 



0000072 74647 56475 12000 OOOOO 

0000073 00033 36401 00007 JOOOS 

0000074 O0D1J 56404 00035 00025 

0000075 00035 56406 00057 50002 

0000076 OOOOO OOOOO OOOOO 00000 

0000077 00007 754O0 00400 07200 
0090100 OOOOO OOOOO OOOOO 00000 



CO a e 
<z p tr v 

C f E 



/ KU » 0000107 00054 1J7O0 01065 34117 E64 AFS60 



CM 1,50,110. » 
0O00O50 0000 0000 0000 0000 0000 



• fOMMT Mine. 



0000052 0000 
000005} 3076 
0300054 3413 

0000055 0165 

0000056 0000 

0000057 7777 
0000060 0075 

CM 



0000 0000 O000 7240 5 

6010 3010 0574 3001 x hxhe W 

1442 3412 1473 0200 1ICL71.iL « 

3014 0100 0341 7761 A XLA C6 
0000 0000 0000 7164 

5122 3000 3200 0000 fltt 2 

1100 0000 0000 0000 t 



0000061 7777 0000 

0000062 0000 oooo 
0090063 0000 0000 

0000064 OOOO OOOO 

0000065 0004 2711 

0000066 0000 OOOO 



COCO 0000 
0001 0653 
OOOO 0000 
OOOO 0005 
0000 0000 
0000 OOOO 



0000 

4137 
OOOO 
1426 
0000 
0000 



0000072 7464 7S64 7512 OOOO OOOO 

0000073 0003 3364 0100 0073 0005 

0000074 0003 3564 0400 0350 0025 

0000075 0003 5564 0600 0575 0002 

0000076 OOOO 0000 0000 OOOO OOOO 

0000077 0000 7754 OOOO 4000 7200 
0009100 OOOO 0000 0000 OOOO OOOO 



CO A E 
C2 6 CI V 
C F E 



0000070 0000 0033 

0000071 74S0 O0O1 



0024 0404 
2225 0000 



OOOO 

7421 



T»l> 

/ mhi a 



0000107 OO05 4137 0001 0653 4117 £64 AF560 



£, 50,110. 



E - HMMT WIMP. 



oooooso ooooootjooooooooooooo craooooooeooooooooooo 00000000000000007240 30766010301005743001 

B00W,S4 M1SM i££H!£i2!££ ^tfSJffHSPJSiilllS? 00000000000000007164 77775^122300^2000000 1KL71JL B A XIA C6 

0000064 00000000000000051426 00042711009000000000 00O0O8O0O00O0 C0 O0 O0O 00000000000000000000 ItV Mil 

0900070 00000033002404040000 7*590001222500007421 74647564751200000000 00033364010900730095 1M / Atll i 

0000074 0003356404000350002$ 00035564060005750002 00000000000000009900 00007754000M0007200 C2 6 %1 U C F E I 
0W010O 00000000900009000000 OOOOOOOOOOOOOOOOOOOO 000009000009 0990000 ( 



51 KXHC XA 
»X 2 

AF464 

1 CO A E 

= 5 



0000104 0000000000090099900 t 



OOOOOOOOOOOOOOOOOOOO 00054137000106534117 



Figure 6-11. Sample C Directive Output 
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Express Deadstart Dump Interpreter (DSDI) 6-71 



Printer Output Listing Examples 



Example 6: 



Figure 6-12 illustrates the printer output listing of the system file name table produced by 
the FNT dump directive. This table is printed in the same format as that produced by the D 
memory dump option (refer to example 5). 



R» • 
OOOOOOO 



fNT. 
FNT OOOO 



D«) ©o OSCI 9WD2/OS. 15.13. *t. PACE 13 

lA.3O.0J. >»/Ct/21.(l>* I CT1T0-730 SN»t* NOS DEVFLDPPSNT. NOS 11F2/!0R*/5CI .. 



SYSTIN FILENAME TAH.E 



FNT 0090 
Flit NANE 
RES/FAT INDEX 
FILE TVPE 
MSE**EO/IBTE«LOC« 

FNT O0O1 

FILE NAME 

MS/MT INDEX 

FILE TTM 

RE S{« VED/ INTERLOCK 

FNT C002 
FILE MKE 
RES/FAT INCEX 
FILE T»« 
•ESER«ED/1*TERL0CK 

FNT O003 
FILE NAME 
RES/FAT INK* 
FILE TYPE 
RESERVED/INTERLOCK 

FNT 000* 
FILE NANS 
KF.S/FAT 1N0EI 
FILE TYPF 
RESERVED/INTERLOCK 



fNTC 07537* 233l?32*OS1500 SY3TFN H EST ORDINAL 

00 FJRJT TRACK 

10 USD COUNT fO« NOO/APP/RD 

SO ATTACH nOOt/UPDATE COUNT 



fSTc 0253TJ OOOt 



FNTC 02537A 2223300**13700 RSXD&4 K EST ORSlNAL 

00 F1RSI TUCK 

13 USER COUNT FCR NCO/AFP/RO 

00 ATTKC* NODE /UPDATE COUNT 



FSTC 025377 0077 



FNTC 024400 22233026*13700 RSXV** K EST ORDINAL 

00 FIRST TRACK 

13 USER CCWNT FCC MOO/APP/RO 

00 ATTACH NOOE/UPDATE COUNT 



FSTC 025*01 00 77 



fntc 025*02 2022171*111*03 profilc e est ordinu. 

00 first track 

13 user count fd* hoo/app/ro 

00 attack ndoe/up0ate count 



F$TC 025*03 0077 



FNTC 025*0* 2*011 « 110*2 523 VALIUM < EST ORbtKAL 'STC 025*05 0077 

00 FIRST TRACK 6 

13 USER COUNT F0» HOO/AFP/RD 

00 ATTACH NOW/UPDATE COUNT 



Figure 6-12. Sample FNT Directive Output 



Example 7: 



Figure 6-13 illustrates the printer output listing produced by the PRORF directive for 
CYBER 180 model 990 and 995 machines. 



IRA ■ 


PROR*. 










PUNP 


00 


»3BI 




tS/W/07. 17.2I.S*. 


PA«i 1 


MOOOM 


<N 


0».0».« 


. ts/07/2*. c»c ainiMB: opir'TIHC s»»t«n 


DOS 2. 






RAA1AL NCt = 1 






















COO CaRRENT INSTRUCTION REGISTER 


INSTRUCTION RUFFRR STACK 






• 


•000 


OMO 


MOO 


2000 







<700 


»«2 


oooo 


AAH 




1 


00*0 


2*00 


OOM 


0070 




1 


FKfO 


imu, 


AFJJ 


F250 




2 


woo 


•000 


OOM 


OOM 




2 


»•« 


9H2 


IMO 


ooot 




S 


0*00 


oooo 


OMO 


M7B 








• 








< 


FFFF 


ROM 


FBFf 


efof 








■ 








J 


FFFF 


FSRC 


POFF 


E003 








. 








* 


•003 


EOM 


MPF 


two 




42 


M*J 


225A 


oc*o 


422* 




7 


JCFF 


CMD 


MFO 


EOM 




»3 


*ie» 


CRCR 


Sf.41 


CI10 




CKEOT1K atws 


Of SOFT CONTROL HERON] ES 


RC«1STER 


UNIT 










ACO K 


OMO 


2M0 


OOOO 


OMO 




A* 


OOM 


1M* 


WOO 


07FC 




aco as 


00** 


MOO 


OOOO 


OOM 




A1 


OOM 


FFFF 


MOO 


OOM 




»c» w 


0—0 


0*00 


OOM 


MOO 




A2 


OOM 


FFFF 


MOO 


OOOO 




RRP 


oon 

0000 


MOO 
MOO 


OOM 
OOM 


OOM 

MOO 








* 








RPN St* 


OHO 


•TOO 


0M< 


(2*0 








. 








EPN ETN 


•000 


OOM 


0<M 


F200 




SKA 


07FF 


CJF2 


4E«t 


5500 




IMP CS 


MOO 
MM 


OOM 
OOM 


OOM 


MOO 
OOM 




%Xf 


07Ff 


0JF2. 


*E*t 


3500 




» RRP 


•000 


OOM 


MM 


»«F2 
















ink as 


FFFF 


ffff 


PFF» 


ffff 


MISTO FILK 










t*N 


OOM 


OOM 


■•00 


oooo 





X-RF.G 


OOOO 


0*00 


MOO 


00*0 




»* W 


HON 


MM 


•FFF 


F01» 






A-REO 

F> « 


IMO 
DM2 


MOO 
44*0 


003 E 

«CM 






ERROR IWMNATXO* TARLE 




1 


X-RCS 


MFC 


COOO 


OTAt 


*M» 







OMO 


MOO 


OOM 


P2M 


i 


A-RU 


mff 


OOOF 


ECM 






1 


was 


MOO 


0101 


F210 


i 


•, » 


0O02 


*64« 


(AM 






2 


OMO 


■MO 


0202 


F220 








: 












; 






* 


«-««« 


oooo 


oooo 


OMO 


OOM 




1* 


OOOO 


OOOO 


MM 


F2E0 


F 


A-RE6 


IRM 


OOM 


MOO 






15 


oooo 


OOM 


OFOF 


F2F0 


F 


P, ■ 


0002 


u*o 


MOO 







Figure 6-13. Sample PRORF Directive Output 
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Install Command 



NOS allows you to deadstart from a disk rather than from a tape. To deadstart from a disk, 
you must first use the INSTALL command to install a deadstart file that you specify to a 
deadstart disk. The disk that you select must be available on a single-unit device such as an 
844 or 885-11/12, 1 and must have the Common Test and Initialization (CTI) software. (For 
more information about CTI, refer to the CYBER Initialization Package User's Handbook.) If 
the deadstart disk is a shared device in a multimainframe environment, a full INITIALIZE 
must have been previously done. The calling job must be of system origin or you must be 
validated for system origin privileges and the system must be in debug mode. In addition, in 
a secured system, INSTALL is allowed only from jobs with security administrator privileges. 

You must re-execute the INSTALL command if a full INITIALIZE becomes necessary, 
because PFDUMP and PFLOAD do not dump or load the system deadstart file (SDF). 

The format of the command is: 

INSTALL , f i 1 ename , EQe s t . 

Parameter Description ^^^ 



filename Disk file (assigned to the job) to be installed as an SDF. Default is SYSTEM, 
which must be assigned to the job. The name SDF is a reserved file name 
and cannot be specified for filename. 

INSTALL stops reading the system deadstart file at the first EOF; therefore, 
the new running system does not include any changes made through 
SYSEDIT after a previous deadstart. 

If the deadstart file to be installed is on tape, it must first be copied to disk 
before INSTALL can be used. 



NOTE 



The deadstart file to be installed must contain a valid OPLD directory. Note 
that when you use LIBEDIT to update a deadstart file and write the new 
deadstart file directly to tape, the OPLD record on the tape will not contain 
valid disk addresses. Therefore, if you want the deadstart file on tape and 
you intend to later use the BMSTALL command on the deadstart file, you 
should have LIBEDIT write the new deadstart file to disk, and then copy the 
file to tape using the COPY command (refer to the NOS 2 Reference Set, 
Volume 3). 



est EST ordinal of the deadstart disk on which file filename is to be installed. 



1. The system deadstart file cannot be installed to an 819. 885-42, 887. or 9853 disk. 
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K-Display Utilities 8 

FLAW K Display 8-3 

INITIALIZE K Display 8-8 

Machine Recovery (MREC) Utility K Display 8-16 

MREC Procedures 8-17 

Using MREC with the K Display 8-17 

Using MREC without the K Display 8-22 

MREC Unit and Controller Reservations 8-22 

Mass Storage Extended Subsystem (MSE) K Display 8-24 

Network Access Method (NAM) K Display 8-26 

Display Control Characters 8-28 

NAM K-Display Operation 8-29 

NAM Mode Maintenance Commands 8-31 

DB Command 8-31 

DE Command 8-32 

DU Command 8-32 

FL Command 8-33 

LB Command 8-33 

LE Command 8-34 

LR Command 8-34 

RS Command 8-35 

ST Command 8-36 

Queue File Transfer Facility (QTF) K Display 8-40 

QTF Selection Classes 8-40 

File Selection Process 8-40 

Visualizing the File Selection Process 8-41 

Queued File Size Index 8-43 

Queued File Size and Transfer Times 8-43 

QTF K-Display Usage 8-44 

QTF Operation Under RHF 8-44 

QTF Operation Under NAM 8-45 

QTF K Display Commands 8-46 

CLASS Command 8-47 

DISABLE Command 8-48 

ENABLE Command 8-48 

HELP Command 8-49 

IDLE Command 8-49 

INCLUDE Command 8-50 

SCHED Command 8-51 

STATUS Command 8-52 

QTF Physical Identifier K Display 8-54 

QTF Selection Class K Display 8-56 

QTF Transfer K Display 8-57 

STOP Command 8-58 

REDEFINE K Display 8-59 
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Remote Batch Facility (RBF) K Display 8-70 

Remote Host Facility (RHF) K Display 8-73 

RHF Initiation 8-74 

Operator Interface 8-74 

RHF Commands Under K display 8-76 

Application Table Display 8-77 

Network Path Table Display 8-78 

RHF Commands Available Under Application or Network Path Display .... 8-81 

RHF Termination 8-81 

SCOPE 2 Station Facility (SSF) K Displays 8-82 

Operator Interface 8-82 

Station Login 8-82 

Enabling and Disabling File Transfers 8-82 

Station Recovery 8-83 

Station Disconnection and Logout 8-83 

File Transfer Limit Commands 8-84 

Staged File Transfer Commands 8-84 

Spooled File Transfer Commands 8-85 

Transaction Facility (TAF) K Displays 8-86 

TAF Initialization K Display 8-86 

Restarting TAF K Display 8-90 

TAF Status K Display 8-90 

TAF K-Display Commands 8-92 

TAF/CRM Status K Displays and Commands 8-96 
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K-Display Utilities 



8 



This section documents the K displays listed next, along with the utilities used to present 
them. Other K-display utilities described elsewhere in this manual include the permanent 
file utilities, queued file utilities, and the status/control register simulator. K-display 
utilities described in other manuals include those for the CDCNET network (refer to the 
CDCNET network manuals) and the printer support utility (refer to the NOS Version 2 
Operations Handbook). 



K Display 



FLAW 

INITIALIZE 

Machine Recovery (MREC) 

Mass Storage Extended Subsystem 

(MSE) 

Network Access Method (NAM) 

Queue File Transfer Facility (QTF) 

REDEFINE 

Remote Batch Facility (RBF) 

Remote Host Facility (RHF) 

SCOPE 2 Station Facility (SSF) 

Transaction Facility (TAF) 



Description 



Disk flaw mapping. 
Disk initialization. 
Multimainframe device recovery. 
K display of the MSE. 

Operator interface to NAM. 
K display of the QTF application. 
Online reconfiguration display. 
K display of the RBF Subsystem. 
K display of the RHF Subsystem. 
K display of the SSF Subsystem. 
K display of the TAF Subsystem. 
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By using the K display, a job can place information on the console screen and receive 
information from the keyboard. The information is passed to the job by DSD. Normally, 
these displays are used for utility programs. 

The job first issues a request message on the B,0 display, asking you to bring up the K 
display. 

When this happens, enter: 

K, jsn. 

jsn Description 

jsn Job sequence name of the requesting job. 

Once the display is assigned to a job, you can enter data by typing K followed by data. The 
data is transferred to a specified area of the job's field length when you terminate the entry. 
If more than 50 characters are entered as data, the message 

LINE TOO LONG. 

appears on the screen. DSD does not accept the entry until the data string is shortened. 

K displays are job oriented. The job sequence name associated with each K display appears 
at the top of the screen next to the display designator and name. 

All parameter entries must be prefixed by K period (K). However, after pressing CR or 
NEXT for the first parameter entry, everything but the K. is erased. This allows another 
parameter to be entered without entering K. first. All examples in this section show K. 
although you may not have to enter it. If you have to enter a DSD command during 
parameter entry, backspace to erase the K., enter the command, and then continue 
parameter entry by entering EL and the parameter. 
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FLAW K Display 

The FLAW utility reserves (flaws) tracks on any mass storage device during normal system 
operation. Each entry identifies an area of mass storage that is unusable (flawed area) and 
prevents the system from accessing it. Since 881 and 883 disk packs normally contain flaw 
information in the utility sector, the FLAW utility should be used on an 881 or 883 only to 
specify additional areas not currently in the utility sector. Obtain flaw addresses from the 
customer engineer. 

Flawing tracks on mass storage devices is accomplished using the FLAW K displays (figures 
8-1 and 8-2). 



K. FLAW. AAAM 



CURRENT SLF, CLF, SPF, AND CPF ENTRIES 

EQ = EST ORDINAL OF DEVICE. 

NUM VALUES ENTERED TRT OCTAL VALUES * = DUPLICATE 

1 

2 

3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 



ENTER EST ORDINAL. 



Figure 8-1. FLAW K Display (Left Screen) 
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K. FLAW. AAAM 

MASS STORAGE DEVICE FLAWING 
SLF, CLF, SPF AND CPF ENTRIES 



SLF = NNNN SET LOGICAL TRACK FLAW. 

CLF = NNNN CLEAR LOGICAL TRACK FLAW. 

SPF = XX SET PHYSICAL TRACK FLAW. 

CPF = XX CLEAR PHYSICAL TRACK FLAW. 

WHERE 

NNNN = VALID LOGICAL TRACK NUMBER. 
XX = C00O,TOO,SOO (CYLINDER, TRACK, SECTOR.) 
= AOOOOOOO (ADDR/10B, FOR DE/DP ONLY.) 

NUMERIC VALUES ARE CONSIDERED OCTAL UNLESS THE 
DIGITS 8 OR 9 APPEAR IN THE NUMBER, OR A *D* IS 
APPENDED TO THE NUMBER. 

SEE LEFT SCREEN FOR CURRENT ENTRIES, 
UP TO 14 ENTRIES ALLOWED 



Figure 8-2. FLAW K Display (Right Screen) 

All console entry is performed under DSD control. The sequence is: 

1. Call the FLAW utility by entering: 

X.FLAW. 

2. Bring the K display to the left console screen by entering: 

K, jsn. 

jsn Description 

jsn Job sequence name of the job requesting the K display (the 

message REQUEST *K* DISPLAY appears on the B,0 display). 

3. You can bring the flawing instructions up on the right screen by entering KK 

4. Specify the mass storage device on which tracks are to be flawed. Enter: 

K.EQ=est. 

est Description 

est EST ordinal of the mass storage device. 

5. Enter flaws. A maximum of 14 flaw entries is allowed for each call to the FLAW utility. 
In addition, there are four types of flaw entries that may be specified. The general 
format for the K display entry is: 

K.xtk=ta. 
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Variable Description 



xtk Specifies one of the following types of flaw entries. 
xtk Description 



SPF Sets the track reservation table (TRT) entry for the 

specified physical block (track) address(es) in extended 

memory or disk to indicate that the block is unavailable 

for use. 
CPF Clears that TRT flaw entry for the specified physical 

block address(es) in extended memory or disk to indicate 

that the block is available for use. 
SLF Sets the TRT flaw entry for the specified logical track to 

indicate that the track is unavailable for use. 
CLF Clears the TRT flaw entry for the specified logical track 

to indicate that the track is available for use. 

ta Specifies the track address to be reserved. (Refer to table 8-1.) ta 

can be one of the following: 

ta Description . 



trk Logical track address for a disk or extended memory. 

(Use with SLF and CLF.) The variable trk can be any 
octal number in the specified range for the particular 
type of disk drive or extended memory. 

Aaddr Physical block (track) address for extended memory. (Use 
with SPF or CPF.) addr is the extended memory address 
divided by 10 8 . 

Aaddr- Range of physical block addresses for extended memory. 
Aaddr (Use with SPF or CPF.) 

Ccyl, Physical track address for the disk. (Use with SPF or 
Ttrk, CPF.) The variables cyl, trk, and sec can be any octal 
Ssec number in the specified range for the particular type of 

disk drive. 



6. Initiate flawing of the specified device by entering: 

K.GO. 
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The FLAW utility provides two messages in the system dayfile that indicate the results of 
the flawing operation. The first message is: 

nn TRACKS FLAWED. 

nn Description 

nn Octal number of tracks that were successfully flawed. 

The second message appears only if some of the flaws specified were not processed. This 
occurs when the track specified for flawing is already reserved by the system (but not as a 
flawed track). In this case, the following message also appears in the system dayfile. 

nn FLAWS NOT PROCESSED, list. 

Variable Description _^______^___ 

nn Octal number of flaws not processed. 

list List of the logical tracks that were not flawed. 

The entries described here are similar to those entered in the APRDECK (refer to section 3, 
Deadstart Decks) for flawing a device at deadstart time. However, the flaw entries specified 
using the FLAW utility or DSD command INITIALIZE are not recovered if the device is 
initialized at deadstart time. Only the flaw entries specified in the APRDECK will be 
recovered. If a device is initialized during normal system operation (INITIALIZE 
command), all flaws specified in the devices TRT, including those entered using the FLAW 
utility or INITIALIZE command, will be recovered providing the device has a good label at 
the time of initialization. If the label is bad, or cannot be recognized, all current flaws are 
cleared. The left console screen (figure 8-3) shows all flaw entries made through the FLAW 
utility and INITIALIZE command. It fists the flaw entry and its logical track equivalent. If 
the same logical track is referenced by more than one flaw entry, an asterisk appears to the 
right of those entries, so that you are aware that only the last entry takes effect. 
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K. FLAW 



AAAM 
CURRENT SLF, CLF, 



SPF, AND CPF ENTRIES 



EQ = 14 EST ORDINAL OF DEVICE. 

NUM VALUES ENTERED TRT OCTAL VALUES 



= DUPLICATE 



1 SLF=4000. 

2 SLF=4000B. 

3 SLF=4001. 



14 



4000 
4000 
4001 



SLF=4001. 



Figure 8-3. FLAW Utility K Display (Left Screen) 
Table 8-1. Flawing Information for Disks and Extended Memory 







Logical 










Device 


Track 


Cylinders/ 


Tracks/ 


Sectors/ 


Device 


Type 


Range 1 


Device 1 

633 


Cylinder 1 

12 


Track 1 


819, single density 


DV 


4000-5465 


24 


819, double density 


DW 


4000-7153 


1466 


12 


24 


834 


DD 


4000-7135 


1457 


12 


40 


836 


DG 


4000-6565 


1273 


30 


57 


844-21, halftrack 


DI 


4000-7137 


630 


22 


30 


844-21, full track 


DK 


4000-7137 


630 


23 


30 


844-41/44, half track 


DJ 


4000-7147 


1464 


23 


30 


844-41/44, full track 


DL 


4000-7147 


1464 


23 


30 


885-11/12, halftrack 


DM 


4000-7221 


1511 


50 


40 


885-11/12, full track 


DQ 


4000-7221 


1511 


50 


40 


885-42 


DB 


4000-7221 


1511 


12 


40 


887, 4K sector 


DF 


4000-7343 


1562 


4 


46 


887, 16K sector 


DH 


4000-7343 


1562 


4 


13 


895 


DC 


4000-7351 


1565 


17 


3 


9853 


DN 


4000-7726 


2601 


23 


25 


Extended memory 


DE/DP 


4000-7620 








5832, IX SSD 


EA 


4000-7745 


1514 


4 


3 


5832, 2X SSD 


EB 


4000-7745 


1514 


4 


6 


5833, IX Sabre 


EC 


4000-7775 


3135 


7 


6 


5833, 1XP Sabre 


ED 


4000-7775 


3135 


7 


6 


5833, 2X Sabre 


EE 


4000-7761 


3135 


7 


13 


5833, 2XP Sabre 


EF 


4000-7761 


3135 


7 


13 


1. Numbers are in octal. 
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INITIALIZE K Display 

INITIALIZE K Display 

The INITIALIZE command can be used to reconfigure certain removable devices (844-21 
and 844-41/44) to suit your needs. For example, if you currently have two single-unit 844 
packs (DK-ls), both packs can be initialized and linked together to form a multispindle 
device (DK-2). However, this can be done only if the devices to be linked meet the following 
requirements: 

• Same device type. 

• Same channels. 

• Same share status (shared or nonshared). 

• Removable. 

• Not currently in use. 

The INITIALIZE command must be entered to set the initialize status for each device to be 
chained. Current multispindle devices can also be initialized providing all packs that form 
the device are mounted in a logical order as determined by the unit numbers list on the E,C 
display. It is only necessary to enter the INITIALIZE command for the first unit of a 
current multispindle device. The format of the INITIALIZE command is described in section 
5, DSD Commands. 

NOTE 

Examine the FAMC and DAFC fields in the family status display (E,F) before entering the 
INITIALIZE command. The user count for the device must be zero before this command is 
valid. 
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The following steps describe the procedures to initialize and (if necessary) flaw tracks on a 
mass storage device. 

1. Enter the INITIALIZE command for the device(s) to be initialized. Examine the B,0 
display for the following message: 

REQUEST *K* DISPLAY. 

Note the job sequence name of the job displaying the message is CMS. 

2. Activate the K display for that job by entering: 

K,CMS. 

The INITIALIZE K display (figure 8-4) appears on the left console screen. All 
parameters required to initialize and (if necessary) flaw the specified device are entered 
through the K display. 



K. INITIALIZE. CMS 



MASS STORAGE DEVICE INITIALIZATION PAGE 1 OF 2 

INITIALIZE EQUIPMENT 
014 

INITIALIZE REQUEST *TOTAL* 

OPTION DESCRIPTION 

EQ = 014 EST ORDINAL OF DEVICE (5-777). 

FM = FAMILY NAME OR PACK NAME IF TY=X (1-7 CHAR) . 

DN = DEVICE NUMBER (1-77). 

UN = PRIVATE AUXILIARY DEVICE USER NAME (1-7 CHAR) . 

TY = ACCESS TYPE (F OR X ) . 

LA = LOWER ACCESS LEVEL (1-7 CHAR) . 

UA = UPPER ACCESS LEVEL {1-7 CHAR) . 

DM = DEVICE MASK (0-377). 

SM = SECONDARY MASK (0-377). 

NC = CATALOG TRACKS (0-200). 

NP = NUMBER OF PACKS (1-7). 

ENTER OLD FAMILY NAME. 



Figure 8-4. INITIALIZE Command K Display 

The K display lists the options used to initialize a device (under the OPTION column as 
shown in figure 8-4). Refer to table 8-2 for a description of each option. Refer to table 
8-3 for additional information. The EST ordinal of the device to be initialized is listed 
under the INITIALIZE EQUIPMENT heading (see figure 8-4). 
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Table 8-2. Device Initialization Options 



Option 1 Description 



EQ EST ordinal of the device to be initialized. For multispindle devices, this 

ordinal must be the first of the consecutive units in the multispindle chain. 

FM The 1- to 7-character family name. Specifies the permanent file family in 

which the initialized device is to be included. All devices must have a 
family name or pack name. The name (single character zero) is reserved 
and cannot be used. This option cannot be used to change the family name 
of the link device in a multimainframe environment. If you specify TY=X, 
this option specifies a 1- to 7-character packname to be associated with an 
auxiliary device. To clear an existing entry, enter FM=NULL. 

DN The 2-digit (octal) logical device number (from 1 to 77 8 ) that uniquely 

identifies the device in its permanent file family. This option cannot be 
entered if you specify TY=X. 

UN The 1- to 7-character user name. This option is specified only when 

initiahzing an auxiliary device (TY=X). If specified, the device is considered 
to be a private auxiliary device. Only the user name specified will be 
allowed to create files on the device (use SAVE, REPLACE, or DEFINE 
commands). To clear an existing entry, enter UN=NULL. 

TY=F Initialized device may contain direct and indirect access permanent files. 
However, if you specify DM=0, only direct access files can reside on the 
device. If you specify SM=0 and DM=0, the device can contain only special 
system permanent files. Indirect access files can reside only on a master 
device (that is, DM*0). 

TY=X Initialized device is an auxiliary device. This is a mass storage device that 
is not part of a permanent file family. An auxiliary device is a 
supplementary permanent file storage device that may be privately owned 
(UN option specified) or can be shared by many users (UN not specified). 
Auxiliary devices can contain direct or indirect access permanent files. 

LA Lower limit for the access level of the device. This establishes the lowest 

access level of files that can be stored on the device (must not be less than 
the lower limit for the access level of the device as given in its EST entry). 

UA Upper limit for the access level of the device. This establishes the highest 

access level of files that can be stored on the device (must not be greater 
than the upper limit for the access level of the device as given in its EST 
entry). 

1. Device initialization options may be changed only if the total initialization level 
(AL) is specified in the INITIALIZE command. 

(Continued on next page) 
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Table 8-2. Device Initializa tion Options 

Option 1 Description 

(Continued from previous page) 

DM The 3-digit (octal) device mask (from to 377 8 ). This option is required 

whenever a permanent file master device is being initialized. It defines 
which users will have this device as their master device. This option cannot 
be entered if you specify TY=X. 

SM The 3-digit (octal) secondary device mask (from to 377 8 ) used to control 

the residence of direct access files. This option cannot be entered if you 
specify TY=X. 

NC Octal number of catalog tracks (from to 200 8 ; must be a power of 2). This 

option is used only if the number of catalog tracks specified as the system 
default for the device type is not satisfactory. 

NP Number of physical units to be included in a multispindle device. The 

default value is 1. Each unit to be included in the multispindle chain must 
be defined as remov able in the current disk status display (EJM). 

2. Device initialization options may be changed only if the total initialization level 
(AL) is specified in the INITIALIZE command. 



Table 8- 3. Track Flawing Options 

Option 1 Description 2 

SPF Sets the track reservation table (TRT) entry for the specified physical block 

(track) address(es) in extended memory or disk to indicate that the block is 
unavailable for use. 

CPF Clears the TRT flaw entry for the specified physical address(es) in extended 

memory or disk to indicate that the block is available for use. 

SLF Sets the TRT flaw entry for the specified logical track to indicate that the 

track is unavailable for use. 
CLF Clears the TRT flaw entry for the specified logical track to indicate that the 

track is available for use. 



1. Flawing of 881 and 883 disk packs is automatic; only flaws additional to the 
current flaw information in the utility sector should be entered. 

2. Refer to the APR DECK description in section 3, Deadstart Decks, for entry formats. 

3. Enter the INITIALIZE command for each additional device to be initialized. This can 
also be done before activating the K display. In either case, only the first device 
specified will be listed (by EST ordinal) in the K display. Thus, to update the K display 
to show additional devices, enter the following command: 

K. RERUN. 

If more than one device is fisted, they are initialized one at a time as they appear in the 
list from left to right. Multispindle devices (more than one EST ordinal) are considered 
one device. 
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The system has already checked the label on each mass storage device. If the label was 
found to be good, it is necessary to enter device initialization options (requested in 
messages that appear in the K display) to identify the device. This is to ensure that the 
device selected is indeed the correct device to be initialized. The messages appear 
automatically and are displayed until the correct options are entered. If an incorrect 
option is entered, it is ignored. Refer to table 8-2 for a description of each option. 

Examine the family status display (E,F) to determine the current option values. 

The following messages may be displayed and the appropriate response should be 
entered. If none of these messages appears, the device label was not recognized or was 
found to be bad. In this event, proceed to step 5. 



Message 



Description 



ENTER OLD DEVICE 
NUMBER 



ENTER OLD FAMILY 

NAME 



ENTER OLD PACK 

NAME 



ENTER OLD USER 

NAME 



This message appears if the device to be initialized is a 
permanent file family device. Enter the following response: 

K . DN=devicenumber . 

This message appears only if more than one family of 
permanent file devices is currently active in the system. 
Enter the following response: 

K . FM= f ami lyname . 

This message appears only if the device to be initialized is 
an auxiliary device. Enter the following response: 

K . PN=packname . 

This message appears only if the auxiliary device to be 
initialized is a private auxiliary device (associated with a 
specific user name). Enter the following response: 

K . UN=username . 

The user name is written to the account dayfile when the 
device is mounted. 

If you discover that the wrong device was specified in the 
INITIALIZE command, you can clear the initialize status 
for that device by entering: 

K.CLEAR. 

The device to be processed by the clear entry must be a 
valid device. That is, the device cannot have a device 
number that conflicts with another device in its family 
name or a pack name that duplicates one already in the 
system. Its mask bits must meet standard requirements. 
The leftmost device in the list of devices to be initialized is 
cleared. One of the preceding messages will then be 
displayed for the next device to be initialized (if any) 
providing the label on that device is good. 
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5. When the following message appears on the K display, enter the options that specify 
the new characteristics to be associated with the device when it is initialized (refer to 
tables 8-2 and 8-3). 

ENTER PARAMETERS 

The new options can be entered as a string or one at a time. For example: 

K.option 1 =value 1 option J1 =value n . 

or 

K. option 1 =value 1 . 

K . option 2 =value 2 . 

K . option n =value n . 

If flaw entries are to be specified (refer to table 8-3), they must be entered singly, as 
shown in the last example. If the label on the device being initialized was good, all 
current flaws on that device are normally recovered. However, if the label was not 
recognized or was bad, the flaw entries cannot be recovered and must be entered (if 
necessary) using this mechanism. A maximum of 14 flaw entries are permitted. In 
addition to the SLF, CLF, SPF, and CPF entries, the flaw information recorded in the 
utility sector on an 881, 883, or 885 disk pack is read during initialization of 844 
equipment, and the appropriate areas are reserved by the system automatically. 

If the NP option is specified (NP > 1), the device is to be initialized as a multispindle 
device. In this case, the number of packs specified by NP indicates the number of 
spindles to be linked. This is the next n number of devices waiting to be initialized. 
Each device must be defined as removable and mounted on consecutive physical unit 
numbers. To determine if a device is defined as removable, examine the disk status 
display (E,M). If the units are configured correctly, the label on each unit is checked. If 
any label is not recognized or is bad, that unit is free for initialization and cha ining . 
However, if the label is good, the message 

ENTER IDENTITY OF EQest 

appears in the K display (est is the EST ordinal of the device). Enter one of the 
following responses. 

K . DN=devicenumber . 

K . FM=f amilyname , DN=devicenvraiber . 

K . PN=packname . 

K . PN=packname , UN=username . 

This is a precautionary measure to ensure that the devices specified are the correct 
devices to be chained. 

6. After all the necessary options have been entered for a specific device, enter the 
following command to proceed with the initialization. 

K.GO. 

If more devices are waiting to be initialized, repeat steps 4 through 6 of this procedure 
for each device. 
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Example 1: 

Suppose you want to create and initialize a multispindle device by linking spindles from two 
separate units. Assume your EQPDECK has the following entries: 

EQ40=DL,ST=OFF,UN=4,CH=27/30. 
EQ41=DL,ST=OFF,UN=5,CH=27/30. 

and you want to initialize multispindle device EQ40, which consists of units 4 and 5. Enter 
the following commands: 

ON, 40. 

ON, 41. 

INITIALIZE , AL, 40 , 41 . 

MOUNT, 40. 

MOUNT, 41. 

K,CMS. 

Enter device initialization options as described in steps 4 and 5. 

K.NP=2. 

When the message ENTER IDENTITY OF EQest appears in the K display, respond as 
described in step 5. 

K.GO. 
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Example 2: 

Assume that you want to initialize a multispindle device and your EQPDECK already 
defines the device as a multispindle device: 

EQ40=DL, ST=OFF, UN=4/5, CH=27/30 . 

In this case, enter the following commands: 

ON, 40. 

INITIALIZE, AL, 40. 
MOUNT, 40. 
K,CMS. 

Enter device initialization options as described in steps 4 and 5. 

K.GO. 

Example 3: 

Suppose you want to initialize a single-spindle device and your EQPDECK defines the 
device as a multispindle device: 

EQ40=DL , ST=OFF , UN=4 / 5 , CH=2 7/30. 

Mount the pack you want to initialize on unit 4 and enter the following commands: 

ON, 40. 

INITI ALI ZE , AL , 4 . 

MOUNT, 40. 

K,CMS. 

Enter device initialization options as described in steps 4 and 5. 

K.PN=1. 
K.GO. 
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Machine Recovery (MREC) Utility K Display 

When a machine that has been in a multimainframe configuration has a malfunction that 
requires a level deadstart, before you can begin the deadstart, the machine recovery 
utility program (MREC) must be run on every machine that shares devices with the 
machine that is not working properly. MREC releases local mass storage space on the 
shared devices and clears interlocks set before the malfunction occurred. 

For example, assume that machines A and B share disk unit 12 and machines B and C 
share disk unit 13 as shown in figure 8-5. 



MACHINE 






MACHINE 






MACHINE 


t 


I 






B 






C 
















1 










DISK 




DISK 






UNIT 




UNIT 








12 








13 







Figure 8-5. Machine Configurations 

If machine A must be deadstarted using a level deadstart, MREC must be run on machine 
B to recover disk unit 12. Machine C need not be involved since it is not aware of the 
existence of disk unit 12. However, if machine B must be deadstarted using a level 
deadstart, MREC must be run on machine A to recover disk unit 12 and on machine C to 
recover disk unit 13. 

NOTE 

Once MREC has been run for an inoperative machine, any level of deadstart on the machine 
other than is not possible. 
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MREC Procedures 

The MREC utility can be used through keyboard entry to a K display or by direct keyboard 
entry under DSD or DIS control without using the K display. 

Using MREC with the K Display 

The following procedure describes K-display usage for MREC operations. 

1. Call the MREC utility by entering this DSD command: 1 

X.MREC. 

2. Examine the DSD system status display (B,0). When MREC is scheduled to a control 
point, it is indicated on the B,0 display. The message 

REQUEST *K* DISPLAY 

appears in the message field for that control point. 

3. Activate the K display for that control point by entering: 

K, jsn. 

jsn Description 



jsn MREC job sequence name. 

The K display for MREC (figure 8-6) appears on the left console screen. 

The MREC left screen K display lists all of the devices that are shared by the machine 
on which MREC is being run. The machine identifier (MID) of this machine is also 
given. Information describing the shared devices is given in the following format. 

eq type un dn fm/pn mids sharing device 
Header Description 



eq EST ordinal of the shared device. 

type Device type. 

un Unit number of the device. 

dn Device number. 

fm/pn Family name/pack name. 

mids sharing Machine identifiers of other machines that are currently accessing 

device the device. If there is an * by the machine identifier, the machine 
is determined to be down. 



1. Under DIS control, the command MREC calls the MREC utility. 
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K. MREC. 






jsn 










hh.itim.ss . 


yy/mm/dd. 


CDC NETWORK 


OPERATING 


SYSTEM 




LVLO 


- 


LVL7 




MID=AA 


NOS version 




MACHINE RECOVERY 


UTILITY 








PAGE 1 OF 1 


EQ 


TYPE 


UN 


DN 


FM/PN 




MIDS 


SHARING DEVICE 


10 


DJ 








PACKV2 


73 


72 


71 


70 


11 


DJ 


1 














12 


DJ 


2 














13 


DJ 


3 


30 


MAINTV2 


73 


72 


71 


70 


14 


DL 


4 


40 


SYS606 


73 


72 


71 


70 


15 


DI 


1 


3 


SYST06 


73 


72 


71 


70 


16 


DI 


2 














17 


DI 


3 





R4IAE 


73 


72 


71 


70 


20 


DJ 


4 














ID OF 


DOWNED MACHINE 


= 72 










EQ(S) 


TO RECOVER 


= ALL 











Figure 8-6. MREC K Display (Left Screen) 
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4. The MREC right screen K display contains the parameters and commands that may be 
selected. Refer to table 8-4 (MREC parameters) and table 8-5 (MREC commands) for 
more information. To activate the MREC right screen K display (figures 8-7 and 8-8), 
enter: 

KK. 

5. Enter the MREC parameters in the following format: 

K.param 1 =value 1 ,param 2 =value 2 , - - - ,param n =value n . 

The parameters entered (and error messages, if any) are displayed on the lower portion 
of the MREC left screen K display. 

6. If you want to reset the parameters to their default values or refresh the device 
descriptions on the MREC left screen K display, enter: 

K. RERUN. 

The parameters can then be reentered. 

7. Enter the desired parameters and initiate MREC processing by entering: 

K.GO. 

When processing is complete, the message 

PROCESSING COMPLETE 

appears at the bottom of the left screen. 

8. After all MREC operations are complete, end the MREC utility by entering: 

K.STOP. 
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Table 8-4. MREC Parameters 



Parameter Description 



ID=id 



EQ=est 



OP=x 



The 1- or 2-character machine identifier of the inoperative machine that is to 
be processed. This parameter must be entered before processing can take 
place. 

EST ordinals of the devices to be processed. Only devices shared between 
the machine that is down and the machine on which MREC is running are 
processed. The form of the entry is: 



EQ=est 1 ,est 2 



, est, 



If you omit this parameter, EQ=ALL is assumed. In this case, all devices 
shared between this machine and the inoperative machine are processed. 

You can enter this parameter only when using the K display (that is, it 
cannot be used if the MREC utility is called by a command) and then, use it 
only if a unit or controller cannot be accessed by MREC due to physical 
hardware reservations. Its use is invalid if a unit reservation is not in effect. 

x Description 

R Directs the MREC utility to release all unit reservations (using the 
GRENADE function; refer to section 2, Deadstart) for 844-41/44 
equipment. 

I Directs the MREC utility to ignore certain functions on the equipment 
for which the reservation message was issued. Functions that do not 
require the unit to be accessed are still performed. 



Table 8-5. MREC Commands 



Command Description 



GO. 

RERUN. 

STOP. 

+ 

) 
( 



Directs the MREC utility to proceed with processing the entered parameters. 

Reinitializes the device descriptions and parameters on the K display and 
reruns the MREC utility. 

Terminates the MREC utility and ends the K-display interaction. 

Pages the left screen K display forward to the next screen. 

Pages the left screen K display backward to the first screen. 

Pages the right screen K display forward to the next screen. 

Pages the right screen K display backward to the previous screen. 
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MREC. 



3sn 



MREC 



PARAMETER DESCRIPTIONS 



PAGE 1 OF 2 



ID 
EQ 



OP 



MID OF DOWNED MACHINE TO PROCESS. 

EST ORDINALS OF DEVICES SHARED BETWEEN THIS MACHINE 

AND DOWNED MACHINE TO PROCESS. ENTER AS 

EQ=XXX,XXX, . . . ,XXX. THE DEFAULT IS EQ=ALL . 

MAY BE ENTERED IF 844 RESERVE SITUATIONS OCCUR. 

THE RESPONSE APPLIES ONLY TO THE CURRENT SITUATION. 

OP=I IGNORE CURRENT DEVICE. 

OP=R CLEAR ALL UNIT RESERVES ON THAT CONTROLLER. 



K DISPLAY COMMANDS 

GO INITIATE PROCESSING OF DEVICES SPECIFIED. 

RERUN REINITIALIZE K-DISPLAY AND RERUN PROGRAM. 

STOP TERMINATE PROGRAM. 

+ PAGE LEFT DISPLAY FORWARD. 
PAGE LEFT DISPLAY BACKWARD. 

( PAGE RIGHT DISPLAY FORWARD. 

) PAGE RIGHT DISPLAY BACKWARD. 



Figure 8-7. MREC K Display (Right Screen) (Page 1 of 2) 



MREC 

DESCRIPTION OF TABLE ENTRIES. 



PAGE 2 OF 2 
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Figure 8-8. MREC K Display (Right Screen) (Page 2 of 2) 
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Using MREC without the K Display 

You can also call the MREC utility and specify the appropriate parameters without using 
the K display. You can do this by making a single keyboard entry (under DSD or DIS 
control) in the following format: 

X.MREC{param 1 =value 1 ,param 2 =value2/ • - • ,param n =value n ) 

The parameters (param^valuej) are described in table 8-4. The ID=id parameter must be 
entered. 

When the MREC command is entered with parameters, the K display is not activated and 
processing occurs automatically. If an error occurs using this procedure, the message 

REQUEST *K* DISPLAY 

appears on the DSD B,0 display. Activate the K display and continue as described under 
Using MREC With the K Display earlier in this section. 

MREC Unit and Controller Reservations 

When attempting to access a device, MREC may find the controller access or unit reserved 
by another machine. When this occurs, the following message appears on the left screen K 
display. 

EQest,CHcc, CONTROLLER RESERVED. 

or 

EQest.UNuu, UNIT RESERVED. 

Variable Description ____^__ 

est EST ordinal of the device. 

cc Channel number. 

uu Physical unit number (from to 77 8 ). 

Assuming the inoperative machine is the machine holding the reservation, you can clear the 
reservation or direct MREC to clear it by using the following procedures: 

To clear a controller reservation, initiate deadstart on the machine that is down. 

To clear a unit reservation, perform one of the following procedures: 

• On a device that is connected to a 7155 controller, initiate deadstart on the machine 
that is down. 

• On a device that is not connected to a 7155 controller, toggle the OFF LINE/ON LINE 
switch on the back of the drive to OFF LINE and then back to ON LINE. 

• If none of the preceding procedures can be performed, select the OP=R parameter to 
clear an 844 device reservation. 
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NOTE 



Do not select the OP=R parameter unless the other reservation clearing procedures cannot 
be performed. It is recommended that all machines in a multimainframe environment be 
put in IDLE status or put in STEP mode when you select the OP=R parameter. 



Once the correct action has been taken, enter 

K.GO. 



to continue processing. If the reservation is still not cleared, the appropriate reserved 
message reappears on the left screen K display. Repeat one of the reservation clearing 
procedures described above or enter: 



K . OP=I . 



This directs the MREC utility to ignore certain functions on the device. Processing may 
then continue. 

If a device or controller in an independent shared device multimainframe environment is 
reserved by a down machine, the previously mentioned messages appear on the system 
status display (B,0) instead of on the K display. Use the procedures already described to 
clear the reservation. 
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Mass Storage Extended Subsystem (MSE) K Display 

MSE uses the K display to present messages that require your action. You can use the MSE 
K display to reply to these messages and to open and close staging/destaging operations. 
You can also use the MSE K display to display a specific storage module's ON/OFF status, 
the number of DRDs within the storage module for staging/destaging, and other information 
including the job sequence name, file name, user index, and PRU count for the files being 
processed. In addition, you can set the maximum number of DRDs to be used for 
staging/destaging operations within a specified storage module. 

When MSE enters messages into the K display, a request for the K display appears on the 
B,0 display. Enter KJVISE to activate the display for MSE. After you have responded to all 
K-display messages, the request for the K display terminates. 

The MSE K display provides space for two messages with up to three lines per message. If 
you request information about a specific storage module, the message area is replaced by 
the information concerning the storage module. Figures 8-9 and 8-10 show the message and 
storage module formats of the MSE K display. 

Valid MSE commands are: 

Command Description 

K.m.GO. Enters a GO response to the message at message ordinal m. 

KSTAGE. Toggles staging operations between open and close. Staging is 

normally open (permitted). 

K.DESTAGE. Toggles destaging operations between open and close. Destaging is 

normally open (permitted). 

KSMi. Displays information for storage module i (i is an SM identifier A 

through H). The display shows SM ON/OFF/MAINTENANCE 
status, the number of DRDs for staging/destaging, and DRD activity 
including the job sequence name, file name, user index, and PRU 
count for the files being processed. 

The display also shows if a DRD is being used for staging or 
destaging, a DRD is under control of a utility, or the state of a DRD 
is maintenance mode, off, or idle. 

KSMi,DRD=ST=s. Sets the maximum number of DRDs to be used for staging within 
storage module i (i is an SM identifier A through H). s is an integer 
through 2; an entry of turns off staging for SMi. 

KSMi,DRD=DS=d. Sets the maximum number of DRDs to be used for destaging within 
storage module i (i is an SM identifier A through H). d is an integer 
through 2; an entry of turns off destaging for SMi. 

MSE clears a message when an acceptable action is taken. Usually this action is entering a 
GO response to the message at message ordinal m. However, for actions such as emptying 
the exit tray on a storage module, the message is cleared when the hardware status 
indicates the action has occurred and you enter the GO response. Refer to appendix B of the 
NOS Version 2 Operations Handbook for the appropriate action for each message. 
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OPEN STAGE 



SUBSYSTEM 
RTRQ* 



■Message ordinal 



OPEN DESTAGE 



VALID COMMANDS 
K.X.GO. 

K.STAGE OR K. DESTAGE 
K.SMI 

K.SMI.ORD-ST-X 
K.SMI, DRO-OS-Y 



'Number of 
stage requests 
waiting to 
become active 
Within SSEXEC 



CLEARS ORDINAL "X* 
TOGGLES OPEN/CLOSE 
SELECTS SM •!» INFORMATION 
SETS MAX *X* STAGE DROS 
SETS MAX *Y* DESTAGE OROS 



Figure 8-9. MSE K Display (Message Format) 



- MSE SUBSYSTEM - 
. - OPEN STAGE RTRQ= 
SMI STATUS ON 

X MAX DRDS FOR STAGING 
Y MAX DRDS FOR DESTAGING 



OPEN DESTAGE - 







JSN 


FILE 


UI 


PRU-S 


DRDO 


STAGE 


- WXYZ 


FILENAM 


USRIDX 


PRUCNT 


DRD1 


DESTAGE 


- ABCD 


FILENAM 


USRIDX 


PRUCNT 



VALID COMMANDS 
K.X.GO. 

K. STAGE OR K. DESTAGE 
K.SMI 

K.SMI,DRD=ST=X 
K.SMI,DRD=DS=Y 



CLEARS ORDINAL *X* 
TOGGLES OPEN/ CLOSE 
SELECTS SM *I* INFORMATION 
SETS MAX *X* STAGE DRDS 
SETS MAX *Y* DESTAGE DRDS 



Figure 8-10. MSE K Display (Storage Module Format) 
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Network Access Method (NAM) K Display 

The NAM K display provides a common, centralized interface by which network 
applications (CS, NS, NVF, or NETOU) can communicate with the host operator (HOP). 

Figure 8-11 shows the format of the NAM K display. Table 8-6 explains the fields that 
appear on the NAM K display. 







data area 






message 






Alert Line 


ALERTS 


appl app2 app3 


app4 app5 


HOP Message Line 


HOP 


hop message line 




Response Line 


appname 


operator entry 


repeat message 



Figure 8-11. NAM K-Display Format 



Table 8-6. NAM K-Display Fields 



Field 



data area 



message 



appl...app5 

hop message 
line 

appname 



operator entry 



repeat message 



Description 



The portion of the screen that receives the output or diagnostic 
message as a result of a command that you entered. This portion of the 
NAM K display is operated as a scrollable paged device. Each line of 
data enters the display at the bottom of the data area and forces the 
previous lines to shift up by one line. The previous top line is lost. 
However, whenever you turn the page-wait status on and more than a 
screen full of information is written to the data area, the prompt MORE 
DATA, is displayed on the bottom line of the data area. The display 
remains fixed until you enter the + character to display the next page of 
information (refer to Display Control Characters later in this section). 

The system prompt READY., indicates that you can make additional 
keyboard entries. The system prompt MORE DATA., indicates that you 
can enter + to see more data. 

The alert fine is a list of applications requesting your attention. 

This field contains a message received from another host. 

The name of the application (CS, NS, NAM, NVF, or NETOU) with 
which you are currently interacting. 

This field contains up to 40 characters of the last command that you 
entered. Commands of more than 40 characters are truncated. 

Whenever a command cannot be accepted because the system was not 
done processing a previous command, you get the system prompt 
REPEAT., in this field. Repeat the command. 
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NAM supports both the right and left screen K displays. The right K display provides help 
information. 

The NAM K display is available at all times during NAM execution, the message 
REQUEST K DISPLAY appears on the B,0 display when the K display is not assigned to 
NAM and some application has requested operator intervention. You must assign the K 
display to NAM to interact with NAM or an application. 

You assign the K display to NAM by entering: 

K,NAM. 

Figure 8-12 shows the NAM K display as it appears when you initially assign it. 



READY.. 

ALERTS 

NAM 



Figure 8-12. NAM K Display 

The NAM K display has two operating modes: 

• NAM mode. 

• Application mode. 

Initially, the display is in NAM mode. The appearance of NAM indicates that you are 
interacting directly with NAM. 
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Display Control Characters 

You can use the following four characters to control the NAM K display. They are valid in 
both NAM mode and application mode. Each of the following characters must be entered in 
the first character position after K 

Character Description 

* When in application mode, the * character causes the display to revert to 

NAM mode. The last command is aborted and any information generated by 
the application, after the asterisk is entered, is discarded by NAM. The 
page-wait status is automatically turned on. The * character is ignored if the 
display is already in NAM mode. 

/ When in application mode, the / character aborts the last command without 

altering the assignment of the NAM K display. The / character always 
results in a READY., prompt. 

When in NAM mode, the / character is ignored. 

+ When in application mode, the + character turns the page-wait status on, if 

the current page-wait status is off. If the current page-wait status is on, 
then the command K.+ displays the next available page of information. The 
page-wait status is always on in NAM mode. The page-wait status is 
initialized to off each time you enter application mode. Therefore, whenever 
you select an application, the page-wait status automatically changes from 
on to off and you can set it as desired. 

- The - character turns off the page-wait status. The - character is ignored if 

entered in application mode while the page-wait status is off. 

Any attempt to turn the page-wait status off while in NAM mode is ignored 
without sending any diagnostic message. 
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NAM K-Display Operation 

Initially, the display is in NAM mode. The application mode is invoked by a NAM mode 
command that indicates the application with which you wish to interact. The application 
mode is indicated by the appearance of the name of that application in the appname portion 
of the response line (refer to figure 8-10). In application mode, all entries except the 
asterisk are passed by NAM to a previously designated application. An asterisk character 
returns the display to NAM mode. 

Entering any command (processed either by NAM or by an application) immediately causes 
the command to appear in the operator entry field. When processing of the command 
completes, the prompt READY., appears in the bottom line of the data area. If you key 
something in, other than one of the display control characters *, /, +, or - before the prompt 
READY., appears, the character is displayed in your entry field but the command is not 
acted upon and the message REPEAT., appears to the right of your entry. 

Table 8-7 describes the commands for assigning the K display to one of the applications CS, 
NS, NVF, or NETOU, and other frequently used commands. If appname or the remote host 
number are invalid or the application is not currently active, you will receive a diagnostic 
message. These commands are available in NAM mode only. 

Table 8-7. NAM Mode Commands 



Command 



K.AP=appname 



KAP 

KHELP 
KIG=appname 



Description 



Assigns the NAM K display to the specified application. The 
application name appears in the appname portion of the 
response line (refer to figure 8-10). appname is one of the 
supervisory programs CS, NS, NVF, or NETOU. The command 
satisfies any alert request posted by the application. When you 
type the application name, that application name is removed 
from the alert line, the page-wait status is turned off, and the 
last page of the application's recent history buffer appears in the 
data area of the display (refer to Recent History Command in 
section 15, Network Operations. 

Assigns the NAM K display to the application whose name 
appears in the leftmost position of the alert line. The page-wait 
status is turned off and the last page of the application's recent 
history buffer appears in the data area of the display. 

Displays information about the NAM mode commands on the 
right K display. 

Causes NAM to ignore all alert requests from the specified 
application. If the application had an alert request pending, its 
name is removed from the alert fist. NAM informs the 
application that its alert request was acknowledged and ignored. 
The rest of the display remains unaltered. This command is 
cancelled automatically when you enter the AP=appname 
command. The assignment of the NAM K display is not altered 
by the IG=appname command. _^__^ 



(Continued on next page) 
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Table 8-7. NAM Mode Commands 



Co mman d 



Description 



(Continued from previous page) 



K.IG 



KEND 



K.SEND,rrr,string. 



Causes NAM to ignore all alert requests from the application 
whose name appears in the leftmost position of the alert line. 
NAM informs the application that its alert request was 
acknowledged and ignored. The rest of the display remains 
unaltered. This command is cancelled automatically when you 
enter the AP=appname command. 

Clears the NAM K display. It causes the data area of the display 
to go blank but leaves the alert line and response line unaltered. 
The END command is used to stop the generation of the status 
display (figure 8-12). Otherwise, if the K display is dropped, 
NAM automatically ends after 60 to 90 seconds. 

Causes NAM to send the message text if a logical link exists 
between the specified remote host and this host. This command 
applies only to hosts that are connected using 255x NPUs, since 
no logical link exists between hosts that are connected through 
either a public data network or a CDCNET network. Use the 
NAM ST command to determine which hosts are connected. 

Parameter Description 



rrr 



string 



Host node number of the remote host (from 1 to 
255). 

Message text of no more than 40 characters. 



The following message is displayed on the specified remote host's 
NAM K display after the alert fine. 

hh.mm.ss. FROM sss string 

Variable Description 

hh.mm.ss Time the message is received. 

sss Host node number of the sending host (from 1 to 



string 



255). 

Message text of no more than 40 characters. 



K.ST 



Causes the NAM status display to appear on the K-display 
screen. 
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NAM Mode Maintenance Commands 

While in NAM mode, the HOP can enter the following network maintenance commands. 
The commands are sent to NAM or to applications to determine the status of the network 
and aid in the debugging of network problems. The HOP may select NAM or a single 
network supervisory application or NAM and all network supervisory applications using the 
following commands: 

C omman d Description 



DB 2 Activates the online debugging code. 

DE 2 Deactivates the online debugging code. 

DU 2 Causes NAM to dump its field length and/or request an application to dump 

its field length. 

FL Changes NAMs maximum field length. 

LB 2 Begins the logging of network traffic in the debug log file. 

LE 2 Ends the logging of network traffic in the debug log file. 

LR 2 Releases the debug log file. 

RS 2 Dumps the statistics data to a permanent file, resets the statistics counters 

to (zero), and continues gathering statistics. 

ST Causes the NAM status display to appear on the K-display screen (refer to 

figure 8-13). 

DB Command 

The debug begin (DB) command causes NAM to turn on its online debugging code and/or 
request an application to turn on its online debugging code. 

The command format is: 

DB=mode . 

mode Description 

AT J, NAM turns on its online debugging code and requests all applications to 

turn on their online debugging code. 

appname NAM requests the specified application to turn on its online debugging 
code. The specified application must be accessing the network or you will 
receive a diagnostic message. 

NAM NAM turns on its online debugging code. 



2. These commands are supported by the network supervisory applications CS. NS, and NVF. They are ignored by IAF, TAF. and 
many other network applications. 
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DE Command 

The debug end (DE) command causes NAM to turn off its online debugging code and/or 
request an application to turn off its online debugging code. 

The command format is: 

DE=mode . 



mode 



Description 



ALL NAM turns off its online debugging code and requests all applications to 

turn off their online debugging code. 

appname NAM requests the specified application to turn off its online debugging 
code. The specified application must be accessing the network or you will 
receive a diagnostic message. 

NAM NAM turns off its online debugging code. 



DU Command 

The dump (DU) command causes NAM to dump its field length and/or request an 
application to dump its field length. 

The command format is: 

DU=mode . 



mode 



Description 



ALL NAM dumps its field length and requests all applications to dump then- 

field length. 

appname NAM requests the specified application to dump its field length. The 

specified application must be accessing the network or you will receive a 
diagnostic message. 

NAM NAM dumps its field length. 
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FL Command 

The field length (FL) command changes NAM'S maximum field length to the specified value. 
If the field length specified is less than NAM's current maximum field length or NAM's 
running field length plus 1000 8 , you will receive a diagnostic message. 

If NAM reaches its maximum field length, use the FL command to increase NAM's 
maximum field length. If the K display is in application mode when NAM reaches its 
maximum field length, NAM automatically switches the K display to the NAM mode. 

Until you enter the FL command, all other NAM commands are rejected and NAM stops 
servicing the network. Frequent need for this command indicates that the initial field 
length for NAM is inadequate and should be increased by changing the MAXFL parameter 
of the NIP command described in the NOS Version 2 Installation Handbook. 

The command format is: 

FL=f 1 . 

Parameter Description 



fl Specified maximum field length in octal, fl must not exceed 360000 8 . If it 

does, NAM issues a diagnostic message to the K display. 



LB Command 

The log begin (LB) command causes NAM to begin logging network traffic in its debug log 
file and/or request an application to begin logging network traffic in its debug log file (refer 
to the NAM Version 1 Host Application Programming Reference Manual for information on 
creating the application's log file). 

The command format is: 

LB=mode . 

mode Description 



ALL NAM begins logging network traffic in its debug log file and requests all 

applications to begin logging network traffic in their debug log files. 

appname NAM requests the specified application to begin logging network traffic in 
its debug log file. The specified application must be accessing the network 
or you will receive a diagnostic message. 

NAM NAM begins logging network traffic in its debug log file. NAM must be 

installed with the network trace option or this command is ignored. Refer 
to the NOS Version 2 Installation Handbook for more information. 

To release the debug log file, enter the log release (LR) command. 
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LE Command 

The log end (LE) command causes NAM to end logging network traffic in its debug log file 
and/or request an application to end logging network traffic in its debug log file. 

The command format is: 

LE=mode . 



mode 



Description 



ALL NAM ends logging network traffic in its debug log file and requests all 

applications to end logging network traffic in their debug log files. 

appname NAM requests the specified application to end logging network traffic in its 
debug log file. The specified application must be accessing the network or 
you will receive a diagnostic message. 

NAM NAM ends logging network traffic in its debug log file. 

To release the debug log file, enter the log release (LR) command. 

LR Command 

The log release (LR) command causes NAM to release its debug log file (if one exists) and/or 
request an application to release its debug log file. When the local debug log file is released, 
its contents are copied to a permanent file. Logging continues on a new local debug log file. 

The command format is: 

LR=mode . 



mode 



Description 



ALL NAM releases its debug log file and/or requests all applications to release 

their debug log files. 

appname NAM requests the specified application to release its log debug file. The 
specified application must be accessing the network or you will receive a 
diagnostic message. 

NAM NAM releases its debug log file. 
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RS Command 

The reset statistics (RS) command causes NAM to dump its statistics to a permanent file 
and restart gathering statistics and/or request an application to dump its statistics to a 
permanent file and restart gathering statistics (refer to the NAM Version 1 Host 
Application Programming Reference Manual for descriptions of the network statistics). You 
can use this command to help analyze NAM and/or application performance. 

The command format is: 

RS=mode. 

mode Description 

AT J, NAM dumps its statistics to a permanent file, resets the statistics counters 

to (zero), and continues gathering statistics and/or requests all 
applications to dump their statistics to permanent files, reset their 
statistics counters to (zero), and continue gathering statistics. 

appname NAM requests the specified application to dump its statistics to a 
permanent file, reset its statistics counters to (zero), and continue 
gathering statistics. The specified application must be accessing the 
network or you will receive a diagnostic message. 

NAM NAM dumps its statistics to a permanent file, resets the statistics counters 

to (zero), and continues gathering statistics. 
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ST Command 



The status (ST) command causes the NAM status display (figure 8-13) to appear on the 
K-display screen. 

The command format is: 

ST. 

The NAM status display provides status information regarding all applications, couplers, 
and logical links currently active in the host. This display is refreshed periodically to 
display the current conditions of the applications and logical links. 

The first line of the NAM status display contains the network invocation number (NIN), 
host regulation level (REG LVL), the number of applications accessing the network, and the 
maximum field length of NAM. 
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Figure 8-13. NAM Status Display 
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The NAM status display shows the application status entries in the following format: 



app 



jsn 



status 1 



ncn ac nsm ndm timeup 



Header 



Description 



app 



Name of the application. The application name may be one of the following 
CDC-written applications or a site-written application. 



app_ 



Description 



ATF 


Automated Tape Facility. 


CS 


Communications Supervisor. 


CYBIS 


CYBIS-NAM Interface. 


IAF 


Interactive Facility. 


ITF 


Interactive Transfer Facility. 


MCS 


Message Control System. 


NJF 


Network Job Entry Facility. 


NETFS 


Network File Server. 


NETLS 


Network Log Server. 


NLTEEM 


Network Log Terminator. 


NETOU 


Network Operator Utility. 


NS 


Network Supervisor. 


NVF 


Network Validation Facility. 


PSU 


Printer Support Utility. 


PTF 


Permanent File Transfer Facility. 


PTFS 


Permanent File Transfer Facility Server. 


QTF 


Queued File Transfer Facility. 


QTFS 


Queued File Transfer Facility Server. 


RBF 


Remote Batch Facility. 


TAF 


Transaction Facility. 


TCF 


Terminal Cluster Facility. 


TLF 


Tie Line Facility. 


TVF 


Terminal Verification Facility. 


VEIAF 


NOS/VE Interactive Facility. 
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Header 



Description 



jsn 
status 



Job sequence name of the executing job table entry. 

Status of the application in octal. Each of the 18 bits (numbered left to 
right) represents the following condition: 

Bit Number Description 

Force flag. 

1 Wait flag. 

2 Rollout flag. 

3 ON flag. 
4-5 Swap flag. 
6 IN flag. 
7-14 Reserved. 

16-17 NVF response flags. 

i Ignore alert flag. If set to Y, NAM ignores an alert 

request from the application. If set to N, NAM accepts 
an alert request from the application. This field is 
blank if the application is not allowed to use the NAM 
K display. 

ncn Number of current connections to the application. 

ac Reserved. 

nsm Number of asynchronous supervisory messages 

currently queued for the application. 

ndm Number of data messages and synchronous 

supervisory messages queued for the application. 

timeup Time, in the format hh.m.ss, that the application 

became active. 



The NAM status display shows the coupler status for all NPU and MDI/MTI coupler entries 
in the EST currently being serviced by NAM. These entries have the following format: 



est 



hn 



nhm nlm 



xvtstat 



prust 



npure} 



Header 



Description 



est 
em 
hn 
nsm 

nhm 
nlm 

ivtstat 



Equipment status table ordinal of the front end NPU or MDI/MTI. 

Equipment mnemonic NP for the NPU or ND for the MDI/MTI. 

Host node number of the coupler. 

Number of asynchronous supervisory messages currently queued for 
the coupler. 

Reserved. 

Reserved. 

Number of characters transferred downline on interactive connections 
in the last 30 seconds. 
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Header 



prust 
npurej 



Description 



Number of characters transferred downline on PEU connections in the 
last 30 seconds. 

Number of times data was rejected by the NPU. 



The NAM status display shows the logical link entries in the following format. 

hn tn h n s t ncn ac nhdq nldq timeup 



Header 



hn 
tn 

h 
n 



ncn 

ac 

nhdq 

nldq 

timeup 



Description 



Node number of the NPU or MDI/MTI coupler. 

Terminal node number of the NPU or MDI/MTI on host-to-network 
logical links, or host node number of the remote host on host-to-host 
logical links. 

Logical link regulation level as reported by the host. 

Regulation level as reported by the NPU or MDI/MTI. n can have the 
following values: 

n Description 

Logical link is down or disabled for data. 

1 Only asynchronous supervisory messages are allowed. 

2 Only asynchronous supervisory messages and high priority 
connections are allowed. 

3 All network connections are allowed. 

Supervision indicator. If CS is using this logical link to send 
supervisory messages, the field is set to S; otherwise, it is blank. 

Host-to-host logical link indicator. If this logical link is between two 
hosts, the field is set to H; otherwise, it is blank. 

Number of current connections on the logical link. 

Reserved. 

Reserved. 

Reserved. 

Time, in the format hh.mm.ss., that the logical link became active. 
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Queue File Transfer Facility (QTF) K Display 

The QTF utility provides a multistreaming capability for transferring queued files between 
mainframes using connections through RHF or NAM. QTF allows you to specify which files 
are to be transferred. You do this by defining a set of selection classes. You can define or 
modify values for selection classes using the CLASS command described later in this 
subsection. You can specify a range of file sizes and the maximum number of simultaneous 
connections allowed. You can also specify a number of reserved connections that cannot be 
used by lower-priority selection classes. 

QTF Selection Classes 

Selection classes are designated by a single letter in the range from A to L. Selection class A 
is the highest priority, and L is the lowest priority. 

QTF uses selection classes to find files to assign to the PIDs (physical identifiers) for remote 
hosts. Associated with each PID is one or more LIDs (logical identifiers). The system 
PID/LID table is created by system program CLDT from the LID configuration file LIDCMid 
(refer to LID Configuration File in section 10) and is viewed and modified using the 
L-display utility LIDOU (refer to LIDOU L Display in section 9). QTF reads the system 
PID/LID table to determine which PIDs have connections through RHF or NAM and which 
LIDs are associated with each PID. 

File Selection Process 

Each copy of QTF has a fixed number of connection slots available. The goal of the QTF file 
scheduling algorithm is to find files for as many of these connection slots as possible within 
the constraints of the selection class definitions. On each pass through its file selection 
process, QTF proceeds through all defined selection classes from the highest priority A to 
the lowest priority L. For each selection class, QTF attempts to find one file for each 
available PID that does not already have a file assigned. The file selection process continues 
until one of the following occurs: 

• All connection slots are in use, or 

• All PID/selection class combinations have been checked and 

- Are in use, or 

- Are unavailable (disabled or the maximum number of connections per selection 
class has been reached), or 

- No files were found. 

• The sum of the reserved connections for higher-priority selection classes is equal to or 
exceeds the number of free connection slots. 
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Visualizing the File Selection Process 

To visualize the file selection process, imagine that selection classes and PIDs form a 
two-dimensional matrix of jacks on a telephone switchboard with PIDs assigned across the 
columns and selection classes assigned down the rows. Above each jack is a light. When a 
light is flashing, a queued file is available for the corresponding PID/selection class 
combination. The plug cables represent the connection slots. A jack can have only one plug 
inserted at a time. Inserting a plug into a jack establishes a connection and causes the light 
to stop flashing and a file transfer to begin. A plug is removed from a jack after one or more 
files have been transferred or a connection error occurs. 

Figure 8-14 shows the connection slot array (plugs) and the PID/selection class matrix 
(switchboard). 
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Figure 8-14. Connection Slot Array and PID/Selection Class Matrix 

On each file selection cycle, QTF looks for a free plug cable (an unused connection slot) and, 
starting at the upper left corner of the PID/selection class switchboard, searches across each 
row in turn looking for a flashing light (queued file matching the PID/selection class 
combination). When the plug is inserted into the jack, that connection is established. If 
another plug cable is free, the search continues from the current jack until QTF runs out of 
plugs or the bottom right corner of the switchboard is reached. 
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For each selection class row for which a reserved number of connections is defined, QTF 
checks the number of plugs inserted in that row when the rightmost jack for the row is 
reached. If the number of plugs inserted is less than the number of reserved connections, 
QTF places enough plugs in unused jacks in that row until the number of reserved jacks is 
filled, only one free plug remains, or the row is filled; whichever occurs first. 

For each selection class row for which a maximum number of connections is denned and the 
maximum is reached, QTF continues searching at the leftmost jack of the next row down. 

You can minimize the number of different operating system calls QTF must make to cover 
all of the switchboard jacks. Do this by either minimizing the number of selection classes 
(number of rows) or by defining overlapping selection criteria for selection classes. For 
example, if selection classes A, B, and C all have the same file size index range, and QTF 
does not find a file for a PID in selection class row A, QTF can consider selection class rows 
B and C checked as well. If selection class D has a different, nonoverlapping file size index 
range, QTF must call the operating system to check the jacks in selection class D regardless 
of the results of the checks for selection classes A, B, and C (assuming that the file selection 
process has not yet terminated). 
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Queued File Size Index 

QTF file size selection criteria are specified in terms of a queued file size index. The 
NOSTEXT symbols FSI1 through FSI6, defined in NOS common deck PPCOM (refer to the 
NOS Version 2 Installation Handbook), allow you to completely and uniquely partition the 
range of queued file sizes into seven subranges. Each subrange is identified by an integer 
value in the range from 1 to 7, known as a file size index. The FSIn values define end 
points for each file size subrange in units of PRUs (640 6-bit characters). 

FSI File size subrange 



1 < size < FSI1 

2 FSI1 < size < FSI2 

3 FSI2 < size < FSI3 

4 FSI3 < size < FSI4 

5 FSI4 < size < FSI5 

6 FSI5 < size < FSI6 

7 FSI6 < size 

Each NOS queued file is assigned a file size index value based on its size. This value is 
displayed on the DSD Q displays (refer to the NOS Version 2 Operations Handbook). 

You can examine the NOS common deck PPCOM to determine the default values for the 
FSIn symbols. However, to modify the current values, you need to rebuild NOSTEXT, the 
NOS operating system, and QTF under RHP. For each FSIn symbol, the value of FSIn must 
be less than the value of FSIn+1. 

The file size ranges are displayed on the QTF help display (figure 8-15). 

Queued File Size and Transfer Times 

Given a typical set of file size index values, the following shows the approximate file transfer 
time in minutes for various line speeds. The time is based on typical line utilization and 
only one transfer active through the line. NAM line speed is shown in minutes. 
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QTF K-Display Usage 

The following procedures describe DSD K-display usage for QTF operations. QTF is used by 
both the RHF and NAM subsystems. 

QTF Operation Under RHF 

Normally, QTF is defined as an autostart application in the RHF configuration file (refer to 
RHF Configuration Files in section 10). That means a QTF job starts automatically when 
the RHF subsystem is initiated. The RHF application table K display shows how many 
copies of QTF are defined and how many copies are currently active. 

QTF terminates when the KIDLE command terminates the RHF subsystem. To manually 
terminate a copy of QTF, bring up the RHF application table display by entering the 
following commands: 

K,RHF. 
K.APPL. 

When the display appears, enter: 

DISABLE, ord. 

where ord is the ordinal of an active QTF in the RHF application table display. The 
message QTF, NETWORK IDLEDOWN IN PROGRESS should appear in the QTF job 
dayfile. QTF completes any files in progress and then ends. If QTF does not terminate 
within a reasonable amount of time, use the DSD DROP command to terminate QTF. 

If a fault condition occurs, QTF normally restarts itself. To manually restart QTF, bring up 
the RHF application table display by entering the following commands: 

K,RHF. 

K.APPL. 

When the display appears, enter: 

ENABLE, ord. 

where ord is the QTF ordinal in the RHF application table display. 

You can determine the jsn of QTF by using the DSD system status display (B,0) and the 
RHF application table display. When QTF is active at a control point, it is indicated on the 
B,0 display. 

Activate the K display for that QTF by entering: 

K, jsn. 

where jsn is the job sequence name for QTF. The QTF transfer display appears on the left 
screen. 
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QTF Operation Under NAM 

Normally, QTF is started by NAMI during NAM subsystem initiation. The NAM status K 
display shows how many copies of QTF are currently active. 

QTF terminates automatically when the NAM subsystem is terminated. To manually 
terminate a copy of QTF, use the NVF IDLE or DISABLE commands (refer to NVF Control 
Commands in section 15) to either idle QTF or immediately terminate QTF. Enter the 
following commands: 

K,NAM. 

K.*. 

K . AP=NVF . 

K.IDLE,AP=QTF. or K. DISABLE, AP=QTF. 

The message QTF, NETWORK IDLEDOWN IN PROGRESS or QTF, NETWORK 
SHUTDOWN should appear in the QTF job dayfile. If the IDLE,AP=QTF command is used, 
QTF completes any files in progress and then ends. If QTF does not terminate within a 
reasonable amount of time, use the DISABLE,AP=QTF command or DSD DROP command 
to terminate QTF. 

If a fault condition occurs, QTF normally restarts itself. To manually restart QTF, enter the 
following command (refer to the NAMI command in section 16): 

X.NAMI(RS=QT) 

You can determine the jsn of QTF by using the NAM status K display. Bring up the NAM 
status K display by entering the following commands: 

K,NAM. 

K-*. 

K.ST. 

Activate the K display for that QTF by entering the following command: 

K, jsn. 

where jsn is the job sequence name for QTF. The QTF transfer display appears on the left 
screen. 
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QTF K Display Commands 

QTF commands have the same general format whether they are entered through the K 
display or read from an input file using the INCLUDE command. 

• Each QTF command must be on one line and only the first 80 columns of a command 
line are significant. 

• A command consists of a command verb followed by to 10 parameters. 

• A command verb and parameters are separated by one or more spaces or a comma. 

• A command is terminated by a single period. 

• Most command verbs and parameters can be abbreviated. The exceptions are IDLE and 
STOP. 

QTF accepts the following K display commands: 
Command Description 



CLASS Define or modify QTF selection class values. 

DISABLE Change the status of QTF elements from enabled to disabled. 

ENABLE Change the status of QTF elements from disabled to enabled. 

HELP Displays information about the available QTF commands. 

IDLE Begins the idle-down process of QTF. 

INCLUDE Causes QTF commands to be read from an input file. 

SCHED Modify QTF scheduling parameters. 

STATUS Displays information about the status of file transfers in progress, PIDs, or 
QTF selection classes. 

STOP Causes an immediate termination of QTF. 

+ Page forward to the next screen of a multipage display. 

- Page backward to the previous screen of a multipage display. 

Comment line (anything following a period is ignored). 
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CLASS Command 

The CLASS command allows you to define or modify QTF selection class values. 
The command format is: 

K . CLASS , SC=selclass , FSI=f si , MAXIMUM=max, RESERVE=res . 
Parameter Description 



selclass Selection class name; specify one character in the range from A to L. 

Selection class A is the highest priority class and L is the lowest priority 
class. This parameter is required. 

fsi File size index; specify the file size index or range of indexes using one of the 

following formats: 

Format Description 



fsi File size index in the range from 1 to 7. 

fsil..fsiu File size index range, where fsil < fsiu. 

* An * specifies all file sizes. It is equivalent to entering 1-7. If 

FSI is omitted, the default is FSI=*. 

max Maximum connections; specify the maximum number of simultaneous 

connections for files in this selection class in the range from to the 
maximum available connections (specified by the MAXCONS parameter in 
the QTF SCHED command) or specify *. If or * is specified, all connections 
can be used for files in this selection class. However, only one connection per 
PID per selection class is permitted. Default is or *. 

res Reserved connections; specify the number of connections reserved for files in 

this selection class in the range from to the maximum available 
connections (specified by the MAXCONS parameter in the QTF SCHED 
command). If zero is specified, no connections are reserved for this selection 
class. For each selection class, the number of available connections is 
reduced by the sum of reserved connections for all higher-priority selection 
classes. To prevent a possible overcommitment of connections, QTF allows 
only mxcons-1 connections to be reserved. Default is zero. 

The following default selection class is defined at QTF initiation: 

CLASS, SC=A, FSI=* ,MAXIMUM=* ,RESERVE=0 . 

which allows one file transfer to any one remote host with no restrictions on file size and no 
reserved connections. To modify the default selection class or define other classes, use 
additional CLASS commands. 
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DISABLE Command 

The DISABLE command changes the status of the selected QTF elements from enabled to 
disabled. 

The command format is: 

K . DISABLE , element . 

Parameter Description 

element One of the following: 
PID=pid 
SC=selclass 
SC=selclass,PID=pid 

Option Description 

pid Physical identifier of a given mainframe. Specify PID=* to 

disable all PIDs. 

selclass Selection class in the range from A to L. Specify SC=* to disable 
all selection classes. 



ENABLE Command 

The ENABLE command changes the status of the selected QTF elements from disabled to 
enabled. 

The command format is: 

K . ENABLE , element . 

Parameter Description 

element One of the following: 
PID=pid 
SC=selclass 
SC=selclass,PID=pid 

Option Description 

pid Physical identifier of a given mainframe. Specify PID=* to 

enable all PIDs. 

selclass Selection class in the range from A to L. Specify SC=* to enable 
all selection classes. 
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HELP Command 

The HELP command displays the available QTF K display commands, file size ranges in 
decimal PRUs, and the parameters for the QTF SCHED command. 

The command format is: 

K.HELP. 

The HELP K display (figure 8-15) appears on the right screen. 



HELP PAGE 1 OF 1 

COMMANDS FSI SIZE RANGE 

CLASS, SC=A, FSI=N. . N , MAXIMUM=N , RESERVE=N . 1 0.. 319 
DISABLE, ELEMENT. 2 320.. 511 

ENABLE , ELEMENT . 3 512.. 1023 

IDLE. 4 1024.. 2047 

INCLUDE, FILE=PFN. 5 2048.. 4095 

SCHED, PARAMETERS. 6 4096.. 8191 

STATUS, TYPE. (TYPE=PID,SC, OR TRANSFER) 7 8192.. 999999 
STOP. 

+ OR - PARAMETERS = (FILE SIZE RANGES 

SELSECS=N IN DECIMAL PRUS) 

ELEMENT = ONE OF- MAXCONS=N 

SC=X OR * TIMEOUT=N 

PID=XXX OR * DISABLE=N 

SC=X,PID=XXX RETRY=N 
X=A, B, C , L . LDTRFSH=N 



Figure 8-15. QTF HELP K Display (Right Screen) 

IDLE Command 

The IDLE command causes QTF to idle down and terminate. The message QTF, 
NETWORK IDLEDOWN IN PROGRESS appears in the QTF job dayfile and IDLEDOWN 
appears on the B,0 display. QTF completes any file transfers in progress and then ends. 

The command format is: 

K.IDLE. 

QTF does not accept an abbreviation for this command. 
To restart QTF, enter the following command: 

X.NAMI(RS=QT) 
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INCLUDE Command 

The INCLUDE command causes QTF to rewind the specified input file and begin processing 
QTF commands from that file. 

The command format is: 

K. INCLUDE, FILE=infile. 

Parameter Description 

infile File name from which QTF commands are to be processed. QTF searches for 

a local file with name infile. If the local file is not found, QTF attempts to 
GET or ATTACH permanent file infile from user name SYSTEMX. If QTF 
performs a GET or ATTACH, it returns the file after processing all of the 
commands. This parameter is required. 

A file of QTF commands processed by using the INCLUDE command can itself contain 
another INCLUDE command. Upon executing the second INCLUDE command, QTF 
switches to the new file and does not read anything following the INCLUDE command in 
the old file. 
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SCHED Command 

The SCHED command allows you to modify QTF scheduling parameters. 
The command format is: 

K . SCHED , SELSECS=selsecs , MAXCONS=mxcons , TIMEOUT=tmomins , 
DISABLE=dismins , RETRY=maxrtry , LDTRFSH=ldtmins . 

Parameter Description 



selsecs File selection recall period in the range from 1 to 4095 seconds; specifies the 

minimum amount of time between attempts to acquire new queued files. 
Whenever QTF is unable to fill all connection slots with files, it waits selsecs 
seconds before again attempting to acquire files for unused slots. Default is 
20 seconds. 

mxcons Maximum simultaneous connection slots (to all hosts) in the range from 1 to 

4. Default is 4 connections. 

tmomins Timeout period in the range from 1 to 60 minutes; specifies the maximum 
amount of time QTF waits for a reply from a remote host or access method. 
For the RHF variant of QTF, tmomins also specifies how long QTF waits for 
NAD code conversion resources when applicable. Default is 2 minutes. 

dismins Disable period in the range from 1 to 60 minutes; specifies the amount of 

time for which QTF will not attempt transfers to a PID after an error occurs. 
You can use the ENABLE command to clear the error disabled condition. 
Default is 2 minutes. 

maxrtry Maximum retries in the range from 1 to 50 retries; specifies the maximum 
number of immediate retries that QTF attempts to complete a file transfer 
before error disabling the PID. When QTF cannot complete a connection 
request (the connection is rejected by the local or remote access method or 
QTFS), QTF disables the PID without any immediate retrys. Once the PID 
is disabled, QTF returns the file to the local queue and does not attempt to 
acquire any files for LIDs associated with the PID until either dismins 
minutes have elapsed or you use the ENABLE,PID command to enable the 
PID. Default is 2 retries. 

ldtmins PID/LID table refresh period in the range from 1 to 60 minutes; specifies 

how often QTF updates its internal tables from the system PID/LID table. 
Default is 2 minutes. 
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STATUS Command 

The STATUS command displays the status of selected QTF elements or file transfers. 
The command format is: 

K . STATUS , display . 

display Description 

PID Selects the QTF physical identifier K display which shows the status of 

PIDs, selection classes for each PID, and the number of queued files 
transferred. 

SC Selects the QTF selection class K display which shows the selection 

class definitions and the number of files transferred. 

TRANSFER Selects the QTF transfer K display which shows transfers in progress 

and the number of files already transferred. 

Each QTF status display consists of a two-fine display header and a variable number of 
display items. The lower portion of the screen contains a QTF command and message area. 
Figure 8-16 shows the general format for the QTF status displays. The display fields are 
described following the figure. 



STATUS, type nnnnnn FILES SENT xxx PAGE n OF m 

display header 
display item 1 
display item 2 



display item k 

* 

COMMAND- < last cmd (1-50) > 

idledown < last cmd (51-80) > 

< p r msg > 



Figure 8-16. General Format of QTF Status K Display 
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Field 



Description 



type Display type; PID, SC, or TRANSFER. 

rmrmrm Number of queued files transferred. 

xxx Access method; RHF or NAM. 

n Current page number. 

m Maximum page number. 

last cmd The last QTF command processed. If the command is incorrect, an asterisk 

(*) appears in the line above the command to show the approximate 
position of the character or parameter in error. If the error is in the second 
part of the command (positions 51 to 80), a plus sign (+) appears instead of 
an asterisk. 

idledown This field contains the message *IDLEDOWN* if QTF is in idle-down mode; 

otherwise, this field is blank. 

opr msg This field contains an operator message about the last QTF command 

processed. Refer to the NOS Version 2 Operations Handbook for message 
descriptions. 
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QTF Physical Identifier K Display 

Figure 8-17 shows a sample QTF STATUS,PID K display. 



STATUS, PID 

PID STATUS 

M01 ENABLED 

MO 2 DISABLED 

MO 3 NO LIDS 

MO 4 NO PATH 

MO 5 REJECTING 



nnnnnn FILES SENT RHF 
SC DISABLED SC IN-USE 
AB 

A L 



PAGE 1 OF 1 



Figure 8-17. QTF STATUS,PID K Display 

Each entry in the QTF physical identifier display appears in the following format: 

pid status sc disabled sc in-use 



Header 



Description 



pid Physical identifier of the remote host specified in the NOS system LID table, 

status Status of the PID; status can be one of the following: 



status 



Description 



DISABLED The PID was disabled by the QTF DISABLE command. 

Use the QTF ENABLE command to change the PID 

status to ENABLED. 
ENABLED The PID is available for file selection for enabled selection 

classes. 

NO LIDS No enabled LIDs are associated with this PID in the 

system LID table or the PID is disabled. Use the LIDOU 
L-display utility to display and modify the system LID 
table. 

NO PATH The system LID table does not define a path in service to 

this PID through the access method (RHF or NAM) that is 
available to this copy of QTF. Use the LIDOU L-display 
utility to determine whether an RHF or NAM path to the 
PID is defined and its status. If the path status is OUT 
OF SERVICE, use the RHF network path table display or 
the NAM status display to display the status of the 
network elements linking the two hosts. 
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Header 

status 



Description 



(Continued) 
status 



Description 



REJECTING QTF has temporarily disabled file transfers to the PID 
because QTF was unable to establish a connection to the 
PID or was unable to successfully transfer a file after the 
maximum number of retries. QTF returns the PID to 
ENABLED status after the specified disable period has 
elapsed. (Refer to the QTF SCHED command for 
descriptions of the RETRY and DISABLE parameters.) 
You can use the QTF ENABLE command to immediately 
return the PID to ENABLED status. If the PID returns to 
REJECTING status, examine the QTF dayfile to 
determine whether a connection reject or a particular file 
is causing the problem. 

Currently, for RHF paths and for some types of NAM 
paths, the path status in the system LID table does not 
reflect the status of the remote PID or access method but 
rather the status of the local host network elements used 
to access the PID. Thus, a remote host may be 
out-of-service (due to scheduled maintenance, for 
example), yet the local system LID table shows the path 
status as IN SERVICE. Each time the disable period 
elapses, QTF attempts to send files to the PID. If the 
access method rejects the connection, QTF returns the 
PID to REJECTING status. 

sc disabled Selection classes that are unavailable for this PID. They were disabled by 
the QTF DISABLE command. Use the QTF ENABLE command to enable a 
particular PID and selection class combination. 

sc in-use Selection classes currently in use for this PID. The QTF transfer display 

shows the ordinals for connection slots and the selection class associated 
with each slot. 
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QTF Selection Class K Display 

Figure 8-18 shows a sample QTF STATUS,SC K display. 



STATUS, SC 






nnnnnn FILES SENT 


NAM PAGE 1 OF 1 


SC STATUS FSI 


RANGE 


MAXIMUM RESERVED 


IN-USE AVAILABLE 


A ENABLED 


1 


. . 6 





1 2 


B ENABLED 


1 


. 6 





1 2 


C DISABLED 


7 


. 7 


1 





D UNDEFINED 










E UNDEFINED 










F UNDEFINED 










G UNDEFINED 










H UNDEFINED 










I UNDEFINED 










J UNDEFINED 










K UNDEFINED 










L UNDEFINED 











Figure 8-18. QTF STATUS,SC K Display 

Each entry in the QTF selection class display appears in the following format: 

sc status fsi range maximum reserved in-use available 

Header Description 



sc 
status 



fsi range 



maximum 



reserved 



Selection class. 

Status of the selection class; status can be one of the following: 



status 



Description 



DISABLED The selection class was disabled by the QTF DISABLE 

command. Use the QTF ENABLE command to change the 
selection class status to ENABLED. 

ENABLED The selection class is available for file selection for 

enabled PIDs. 

UNDEFINED The selection class has not been defined. Use the QTF 
CLASS command to define or modify a selection class. 

File size index range. This field shows the inclusive range of file size index 
values that are allowed for this selection class. 

Maximum number of connection slots allowed for files in this selection 
class. This field contains dashes ( — ) if no maximum is specified. 

Number of connection slots reserved for files in this selection class. This 
field contains dashes ( — ) if no connection slots are reserved. 
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Header Description 



in-use Number of connection slots that have been assigned files in this selection 

class. This field contains dashes ( — ) if no connection slots are in use. 

available Number of free connection slots available for assigning files in this selection 
class. This field contains dashes ( — ) if no connection slots are available. 



QTF Transfer K Display 

Figure 8-19 shows a sample QTF STATUS,TRANSFER K display. 



STATUS, TRANSFER nnnnnn FILES SENT RHF PAGE 1 OF 1 
ACN SC FILE LID/PID DC DD PRUS STARTED STATUS 
1 A ABCD SV6 M03 PR C8 1234 11.03.45 *START XFR 
CONNECTION ESTABLISHED TO MO 3. 



2 A AAED MFF MFF IN US 22 11.10.00 WAIT REM 
ACQUIRED DC=IN, ST=MFF, DO=MA2 . 



Figure 8-19. QTF STATUS,TRANSFER K Display 

Each entry in the QTF transfer display appears in the following format: 

acn sc file lid/pid dc dd prus started status 

message 

Header Description 



acn Application connection number; this is the ordinal of the connection slot, 

sc Selection class associated with this connection slot. 

file Job sequence name associated with the queued file assigned to this 

connection slot, 
lid Logical identifier of the host associated with this connection slot. 

pid Physical identifier of the remote host to which this slot is connected or is 

being connected. 

dc Disposition code of the queued file. Refer to the ROUTE command in the 

NOS Version 2 Reference Set, Volume 3 for a list of disposition codes and 
their meanings. 

dd Data declaration. This field defines the format of the file data during 

transfer. Values of C6 and C8 indicate that the file is to be sent in 
code-conversion mode. Values of UH, US, and UU indicate that a binary 
transfer is to be used. 
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Header 



Description 



prus 
started 

status 



Size of the file in physical record units (PRUs) in decimal. One PRU 
contains the equivalent of 640 6-bit characters. 

This field shows the time (hh.mm.ss) at which the connection to the remote 
host was initiated. The time is updated when the connection is established 
and at the beginning of each file transfer sequence. 

Status of the connection or file transfer; status can be one of the following: 



status 



Description 



ACQ FILE File has been acquired. 

CONNECT Issuing connect request. 

END CONN Connection terminating. 

FILE XFR File transfer in progress. 

IDLE Connection established. 

QUEUED File transfer successful. 

START XFR Initiating file transfer. 

STOP XFR File transfer completing. 

WAIT ACQ Waiting for acquire queued file response. 

WAIT REM Waiting for response from remote host or access method. 

message This field contains the last dayfile message issued by QTF for this 

connection slot. Refer to the NOS Version 2 Operations Handbook for 
message descriptions. 



STOP Command 

The STOP command causes QTF to terminate immediately. The message QTF, NETWORK 
SHUTDOWN appears in the QTF job dayfile. QTF abandons any file transfers in progress, 
returns files to the system I/O queues, and ends. 

The command format is: 

K.STOP. 

QTF does not accept an abbreviation for this command. 
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REDEFINE K Display 

Use the REDEFINE utility to reconfigure 844 and 885-11/12 3 disk drives online and thereby 
logically eliminate a unit that is malfunctioning without performing a level initial 
deadstart. A single unit or multiunit device 4 that fails can be replaced with an unused unit. 
Unused units must be available or made available across channels or on the same channel 
as the failing unit by physically moving the disk pack from the failing unit to the 
replacement unit. Table 8-8 gives the equipment requirements for reconfiguration. 

Table 8-8. Equipment Requirements for Reconfiguration 



Operation 










To Be 








Special 


Performed 


Current Equipment 


Replacement 


Equipment 


Considerations 




Must be unloaded, 


Must be in 


Must be 






removable 


EST 


unloaded, 
removable 




Add or 


Yes 


No 


Yes 


Equipment must 


Return a 








have less than 


Unit 








eight units. 


Delete a Unit 


Must be removable; if 
not unloaded, the unit 
must be in the EST 


NA 


NA 


Equipment must 
have at least one 
unit. 


Replace a 


No 


Not necessary 


Yes, if in 


The system does 


Unit 






EST 


not perform label 
verification on 
packs that are 
unloaded before 
the failing unit is 
replaced. If the 
unloaded pack is 
not moved from 
the failing unit or 
the wrong pack is 
moved, the system 
issues an error 
message when the 
replacement unit 
is accessed. 


Recable a 


No 


NA 


No 


None. 


Unit 











3. When reconfiguring an 885-11/12 disk drive, a customer engineer must be present. 

4. When reconfiguring a multiunit device, all units of the device must be on the same controllers). 
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NOTE 



There are special cases when you cannot perform an online reconfiguration. In these cases, 
you must perform a level deadstart and define the failing device to another drive. The 
special cases are: 

• Reconfiguring an 885-11/12 disk drive that is the only system device denned. 

• Reconfiguring an 844 or 885-11/12 disk drive that is the only temporary device defined. 

• Reconfiguring a device designated as an independent shared device. 

• Reconfiguring an 819 or 885-42 disk drive. 

The reconfiguration sequence follows: 

1. Request the reconfiguration of the disk device defined by EST ordinal est by entering: 

REDEFINE, est. 

The message REQUEST *K* DISPLAY appears at the appropriate control point on the 
system status display (B,0). You can reenter the REDEFINE command as many times 
as there are devices to be reconfigured. Multispindle devices that include two or more 
units are considered to be one device. 

If an INITIALIZE command is being processed, the REDEFINE entry is not processed 
until the initialization is complete. 

2. Bring the initial REDEFINE K display (see figure 8-20) to the left console screen by 
entering: 

K , j sn . 

jsn Description 

jsn Job sequence name of the requesting job. 

To bring up the right console screen K display, enter: 

KK. 

As shown in the left screen of figure 8-20, the current EST description of the device 
being reconfigured appears under the heading CURRENT EQUIPMENT 
CONFIGURATION. The EST description of the device as changes are made appears 
under the heading REQUESTED EQUIPMENT CONFIGURATION. Any devices listed 
under IDLED EQUIPMENTS are devices that have been previously selected by your 
REDEFINE command but have yet to be processed in the reconfiguration run. 

The left screen K display may not fist all relevant devices. If more than one device is 
fisted, they are processed one at a time as they appear in the list with one exception: 
all shared devices are processed prior to nonshared devices. 
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You are guided through the reconfiguration process in two ways. First, by the list of 
commands and parameters shown on the right screen K display of figure 8-21, and 
second, by the system responses and error messages. 



K. CMS 

hh.iran.ss. yy/mm/dd. CDC NETWORK OPERATING SYSTEM 
LVLO - LVL7 MID=AA NOS version 

MASS STORAGE FAILURE RECOVERY 

CURRENT EQUIPMENT CONFIGURATION 

Oil DJ-1 CH24,01 UL=01 ST = I- 



REQUESTED EQUIPMENT CONFIGURATION 

Oil DJ-1 CH24,01 UL=01 — -- — — — ~ — ST = I 

CHANGED UNITS 



IDLED EQUIPMENTS 

010 DJ-1 CHOI, 24 UL=00 — ST = I- 



Figure 8-20. REDEFINE K Display (Left Screen) 



K DISPLAY COMMANDS 

CLEAR CLEAR IDLE AND SUSPEND ON CURRENT EQUIPMENT. 

END CLEAR ALL DEVICE IDLES AND END *CONFIG* . 

GO INITIATE PROCESSING OF ENTERED CONFIGURATION. 

RERUN RESTART *CONFIG* UTILITY PROCESSING. 

RESET RESET CURRENT EQUIPMENT TO DEFAULT PARAMETERS. 

SUSPEND SUSPEND SYSTEM OPERATION ON CURRENT EQUIPMENT. 

CH=C1,C2 CI AND OPTIONALLY C2 ARE NEW ACCESS CHANNELS. 

EQ=EEE SET EST ORDINAL EEE TO BE PROCESSED. 

UL=U1,U2,... SET UNIT LIST AS SPECIFIED. 

UR=UU UNIT UU IS TO BE RECABLED WITH A NEW DRIVE. 



Figure 8-21. REDEFINE K Display (Right Screen) 
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3. Enter all of the valid parameters (refer to table 8-9) that define the reconfiguration 
characteristics for the specified device. Parameters are entered singly. Parameters are 
processed left to right; no terminator is necessary. 

If you enter an incorrect parameter (for example, the wrong channel number), the error 
can be corrected by entering the correct parameter. 

4. Enter 

K.GO 

to initiate processing of the parameters when all parameters and commands (refer to 
table 8-10) have been entered for the specific device. Enter this command after each set 
of parameters to signal the system to go ahead with the reconfiguration you have 
defined. If more devices remain to be reconfigured, repeat steps 3 and 4. 

5. Enter 

K.END 

to end a reconfiguration run when there are no more devices to be processed. 
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Table 8-9. Reconfiguration Parameters 



Parameter 

CH=c 1 ,c 2 



Description 



EQ=est 



Specifies the channel numbers (c x and, optionally, c 2 ) to be used 
under the new device definition. 

Use this parameter when the entire device is to be redefined to 
alternate channel numbers). You can also use it to add or delete 
channels from an equipment definition. New channels can be added 
by specifying new channel numbers for a defined equipment. 
Channels can be deleted by specifying CH=. when deleting a unit. 
Acceptable values for c x and c 2 are from to 13 8 for systems having 
10 or less PPs; from to 13 8 and from 20 8 to 33 8 for systems having 
more than 10 PPs. Leading zeros can be omitted. 

Specifies the equipment with EST ordinal est is to be processed. 
Enter this parameter when the processing of equipments is order 
dependent; for example, when a device must first be made available 
before it can replace a failing device. The system ignores all 
parameters not processed before you enter the EQ=est parameter. 
Parameters entered after EQ=est refer to the specified equipment 
until you enter another EQ=est or a command that causes the next 
equipment in the fist to be selected for processing. 

UL=u 1 ,u 2 ,...,u n Specifies the unit list for the new configuration. 

When a unit is to be replaced, added, or deleted, the entire unit 
configuration must be entered with this parameter. The equipment 
must be unloaded (multimainframe mode) or otherwise have an 
unavailable status if a unit is to be added or deleted. Any number of 
units can be changed. By specifying UL=. the current unit 
configuration is deleted. 

NOTE 



UR=un 



If the unit number specified in the UL= parameter represents a unit 
that is not defined in the EST, the unit number is accepted without 
validation. Ensure that the unit number entered represents a vahd 
device. 



Specifies that the device with unit number un is to be recabled. This 
parameter is used when a device is to be physically replaced by a 
new device with the same unit number. More than one device can be 
specified for recahling at the same time. 
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Table 8-10. Reconfiguration Commands 



Command 



Description 



ABORT Discontinues processing of the current command. It is entered only in 

response to a detected error condition and is used to initiate error 
recovery procedures. This command cannot be followed immediately by 
an END command. 

CLEAR Clears the suspend and redefinition request status for the current 

equipment. Label and read/write verification of the device is 
performed. This command should be entered only when no further 
processing is desired for the current equipment. 

END Terminates the reconfiguration processing. The K-display parameters 

are set to the default values as control is returned. This command 
cannot be entered immediately after an ABORT command. 

GO Initiates the processing of specified reconfiguration parameters 

previously entered. 

IGNORE Informs the system on which the command was entered to ignore 

processing on this device (multimainframe mode only). This command 
should be entered during an add or delete unit reconfiguration run on 
the machine(s) within the multimainframe complex which, for control 
reasons, cannot add to or delete from the specified equipment. Also, 
you can use this command to ignore an error message pertaining to a 
marginally unacceptable servo timing check, which is performed 
automatically when reconfiguring an 885-11/12 disk drive. 

NEXT Enter this command in response to an 885-11/12 disk drive servo timing 

check that meets requirements. This command causes processing to 
continue with the next device or the next step of processing. This 
command is valid only when reconfiguring 885-11/12 disk drives. 

RECHECK Retries a verification/diagnostic process that previously gave an error. 

Only the commands RECHECK, ABORT, and IGNORE are accepted by 
the system when an error message is issued. 

RERUN Sets the parameters to default values and updates the list of 

equipment to be reconfigured. 

RESET Resets the parameters to default values. 

SUSPEND Causes system processing on the specified device to be suspended 

indefinitely while the device is in a not ready state. Only diagnostic 
access to the device is allowed. All other jobs accessing the device will 
be unable to continue until the device is returned to a ready state. 
More than one equipment can be suspended at the same time. 
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You can stop the reconfiguration procedure by entering either the KABORT command or 
the KCLEAR command (depending on which command is posted in the list of valid 
commands on the K display). In either case, processing advances to the next device in the 
list of devices under IDLED EQUIPMENTS (see figure 8-20). 

If the device specified is a shared device in a multimainframe environment and 
reconfiguration is not desirable on one or more of the mainframes, use the following 
procedure: 

1. Enter at the console of each mainframe for which reconfiguration of the shared device is 
not desired. 

REDEFINE, est. 

est Description 



est EST ordinal of the shared device. 

2. Enter 

K, jsn. 

jsn Description 



jsn Job sequence name of the job requesting the REDEFINE K display. 



3. Enter 

K . IGNORE 

and processing on the shared device in the fist is ignored by that mainframe. The 
machine must wait until the shared device is done with its processing. 

4. Enter 

K.END 

to end the reconfiguration procedure. 
Enter either the RERUN or RESET command to clear the IGNORE command. 
Figure 8-22 shows the output for a sample reconfiguration run. 



ORD 


TYPE 


CHANNELS 


UNITS 


STATUS 


06 


DJ-1 


CH26, 


32 


UL=06 


ST = 


07 


DJ-1 


CH26, 


32 


UL=07 


ST = 


10 


DJ-1 


CH32 




UL=01 


ST = 


11 


DJ-1 


CH13 




UL=02 


ST = 


12 


DI-1 


CH26 




UL=03 


ST = 


13 


DI-1 


CH32 




UL=11 


ST = 


14 


DI-1 


CH26 


32 


UL=04 


ST = I 



Figure 8-22. Reconfiguration Run Output 

Following are examples of the reconfiguration of disk devices and how their status changes 
in the REDEFINE K display. 
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Example 1: 

This example illustrates returning a unit to the system. 

Assume the unit of est ordinal 7, the system's spare disk drive, was used to replace a failing 
disk drive. Now that the defective unit has been repaired, it is to be returned as the unit of 
the spare disk drive. 

Disk configuration before the REDEFINE: 

EST Equipment Channel Unit 

Ordinal Type Number(s) Number St atus 

7 DJ-0 00 - I— 

Enter the following commands: 

Command Description ___^^__ 

REDEFINE,7. 7 is the EST ordinal of the shared device. 

Kjsn. jsn is the job sequence name of the job requesting the REDEFINE K 

display. 

KCH=32,26 32 and 26 are the channel numbers to be used by est ordinal 7. 

KUL=7 7 is the unit number of the device being returned. 

KGO Initiates the processing of all the parameters and commands entered 

for EST ordinal 7. 

The system responds with the message: 

EQ 7 REDEFINITION COMPLETE. 

To end the reconfiguration, enter: 

K.END 

Disk configuration after the REDEFINE: 

EST Equipment Channel Unit 

Ordinal Type Number(s) Number Status 

7 DJ-1 32,26 7 — 
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Example 2: 

This example illustrates reconfiguring a failing unit. 

Assume EST ordinal 10 and EST ordinal 11 are defined in the EST display. Equipment 10 
is a spare unit currently not being used. Equipment 11 has a pack mounted and is the 
failing device. Before the failing device can be reconfigured, the spare unit must be removed 
from the EST. The following stipulations apply when deleting a unit from the EST: 

• If the EST ordinal is defined in a single mainframe environment or if it is not shared in 
a multimainframe environment, then having device unavailable status (U status in the 
E,M display) for that EST ordinal is sufficient. 

• If the EST ordinal is shared in a linked shared device multimainframe environment, 
then that EST ordinal must have device unavailable status and be globally unloaded (U 
and N status in the E,M display) before a reconfiguration can be performed. 

Disk configuration before the REDEFINE: 

EST Equipment Channel Unit 

Ordinal Type Number(s) Number Status 



10 DJ-1 32 1 I— 

11 DJ-1 13 2 — 

To perform the reconfiguration, enter the following commands: 
Command Description 



REDEFINE,10. 10 is the EST ordinal of the spare device. 

REDEFINE,11. 11 is the EST ordinal of the failing device. 

Kjsn. jsn is the job sequence name of the job requesting the REDEFINE K 

display. 
KCH=. Deletes the channel numbers) assigned to EST ordinal 10 from the 

EST. 

K.UL=. Deletes the unit number of EST ordinal 10 from the EST. 

K.GO Initiates the processing of all the parameters and commands entered 

for EST ordinal 10. 

The system responds with: 

EQ 10 REDEFINITION COMPLETE. 

Enter the reconfiguration commands for the failing device as follows: 



Command Description 



KCH=32 32 is the channel number that was assigned to EST ordinal 10. 

KUL=1 1 is the unit number that was assigned to EST ordinal 10. 

K.GO Initiates the processing of all the parameters and commands entered 

for EST ordinal 11. 
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The system responds with: 

SPIN DOWN UNIT 02. 

02 is the unit number of EST ordinal 11. 

After the unit is spun down, the system responds with: 

MOVE PACK FROM UNIT 02 TO UNIT 01 AND SPIN UP. 

After the pack is moved and the new unit is spun up, the system responds with: 

EQ 11 REDEFINITION COMPLETE. 

To end the reconfiguration, enter: 

K.END 

Disk configuration after the REDEFINE: 

EST Equipment Channel Unit 

Ordinal Type Number(s) Number Status 

10 DJ-0 00 — 

11 DJ-1 32 1 — 

Example 3: 

This example illustrates reconfiguring devices across channels. 

Units may be reconfigured across channels with the REDEFINE command. Assume that 
EST ordinal 12 is the failing unit (or possibly the failing channel) and is on channel 26. 
EST ordinal 13 is the spare unit on channel 32. The following commands illustrate a 
reconfiguration across channels. 

Disk configuration before the REDEFINE: 

EST Equipment Channel Unit 

Ordinal Type Number(s) Number Status 

12 DI-1 26 3 — 

13 DI-1 32 11 — 

Enter the following commands: 

Command Description 

REDEFINE,12. 12 is the EST ordinal of the failing device. 

REDEFINE,13. 13 is the EST ordinal of the spare device. 

Kjsn. jsn is the job sequence name of the job requesting the REDEFINE K 

display. 

K.EQ=13 Selects the spare unit to be processed first. 

K.SUSPEND Suspends the spare unit to clear it from the EST. 
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The system responds with: 

SYSTEM USAGE OF EQ 13 SUSPENDED. 

To continue with the reconfiguration on EST ordinal 12, enter: 

KEQ=12 Selects the failing unit for processing 

KCH=32 Assigns the old channel number of EST ordinal 13 to EST ordinal 12. 

KUL=11 Assigns the old unit number of EST ordinal 13 to EST ordinal 12. 

KGO Initiates the processing of all the parameters and commands entered for 

EST ordinal 12. 

The system responds with: 

EQ 12 REDEFINITION COMPLETE. 

Disk configuration at this point in example 3. 

EST Equipment Channel Unit 

Ordinal Type Number(s) Number Status 



12 DI-1 32 11 I— 

13 DI-1 32 11 IS- 

All SUSPEND status flags must be cleared before a reconfiguration run can be ended. The 
system therefore automatically selects EST ordinal 13 again for the next EST ordinal to be 
processed. 

To continue with the reconfiguration, enter: 
Co mman d Description 



K.CH=26 Assigns the old channel number of EST ordinal 12 to EST ordinal 13. 

K.UL=3 Assigns the old unit number of EST ordinal 12 to EST ordinal 13. 

KGO Initiates the processing of all the parameters and commands entered for 

EST ordinal 13. 

The system responds with: 

EQ 13 REDEFINITION COMPLETE. 

To end the reconfiguration, enter: 

K.END 

Disk configuration after the REDEFINE: 

EST Equipment Channel Unit 

Ordinal Type Number(s) Number Status 



12 DI-1 32 11 

13 DI-1 26 3 
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Remote Batch Facility (RBF) K Display 

Whenever RBF is in operation, user connections and activity are shown in the RBF K 
display (refer to figure 8-23). 



RBF Version PSR Level of Number of Terminals Nuaber of Batch 

Number RBF Software Active (Decimal) Devices Active (Decimal) 



REMOTE BATCH TERMINAL STATUS. 

RBF VER 1.2- 52S TERMINALS - 1 



DEVICES 



TERM. 


DEV. 


TCLASS. 


USR/JSN. 


FAMILY/. 




FORMS 


NAME. 


TYP. 


/STATE. 


• 


F1LESIZE. 


ERRORS. 


CODE 


LCCT1 


CO. 


200UT. 


AADC 


NZDCTYR. 


. 






CR1. 


STOP. 


. 


. 


« 






LP1. 


GO . 


AJZA 


40 


. 





Figure 8-23. RBF K Display 

Select the RBF K display with this DSD command: 

K,KBF. 

Data on the RBF display is updated periodically to reflect the current status of batch 
terminals connected to RBF. 

Terminals are identified by termname, a unique name defined by the site. Terminals are 
displayed in alphabetical order. There are multiple lines on the K display per terminal; one 
line for the terminal console, and one line for each batch device (card reader, line printer, 
card punch, or plotter). 

If there are more terminals and devices active than can be displayed on one screen, the 
message 

MORE LINES FOLLOW. 

appears at the lower left corner of the display. You can display additional screens by 
entering: 

K.+ 

The K.+ command advances the display page-by-page and end-around from the last page to 
the first. All screens are displayed in a forward direction. Use of the console input K- does 
not move the screen back to the previous display. 

Entries in the display have the following format: 



term 


dev 


tclass 


usr/ jsn 


family/ 




forms 


name 


typ 


/state 




f ilesize 


errors 


code 
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Header 



term name 



dev typ 



tclass/state 



Description 



Remote Batch Facility (RBF) K Display 



Name of the terminal. A unique name, termname, assigned by the 
installation during network startup. This field is used for console devices 
only. 

Device type. The device type code is one of the following: 



Code 


Description 


CO 


Console device. 


CPi 


Card punch. 


CRi 


Card reader. 


LH 


Line printer. 


PLi 


Plotter. 



The ordinal number, i, of the device can range from 1 to 7. 

If this field is in the same line as the termname, the contents of the field 
is the terminal class mnemonic (refer to the Remote Batch Facility 
Reference Manual). If this field occurs in a line not containing a 
termname, the device status code is one of the following: 



Code Description 



ABRT File in transmission is to be discarded. 

CONN Device is connected (initial state). 

END Device stops transmission at EOI. 

ENDA File being aborted; device will stop at EOI. 

ENDC End connection. 

ENDI Device will stop at EOI; idle down requested. 

GO Device is ready for input. 

NULL Console is not connected, but RBF devices are. This code 

appears only when the device type is a console (device type code 
CO). 

PREC Preconnect status (device connection not complete). 

STOP Device is not ready for transmission of data. 

STPA Device is stopped; current file to be aborted. 

STPE Device is stopped. 

STPI Device is stopped due to idle down request. 
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Remote Batch Facility (RBF) K Display 



Header 



Description 



usr/jsn If a file transfer is in progress, jsn is displayed in this field. If no file is 

being transferred, then the user name appears in this field. 

family/filesize If this field is in the same line as the termname, the content of this field is 
the family associated with the username. The user index and family 
combination determine the terminal identifier used by the system for 
routing jobs. Otherwise, the contents of this field is the size of the output 
file in PRUs. 

errors Contents of this field, if present, is one of the following error messages: 



Message Description 



DISK 
ERROR 

DISK FULL 

NOT 

READY 

QUEUE 
FULL 



Data has been lost due to an unrecoverable disk failure. 

A disk-full indication was received while RBF was 
attempting to write to disk. 

The device the user specified is not available (for example, 
the line printer is out of paper or the card reader has a 
card jam). 

The system input queue has reached its limit of jobs 
waiting to begin execution. 



forms code Forms code for output devices as specified by the user and defined by the 
site. 
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Remote Host Facility (RHF) K Display 

The Remote Host Facility (RHF) links NOS to a loosely coupled network (LCN) providing 
transfer of permanent files, queued files, and maintenance facilities for the LCN hardware. 
Each system in an LCN configuration is connected to one or more LCN trunks by network 
access devices (NADs). Several types of NADs are available, allowing the connection of 
various types of computer systems to an LCN. Each system has an RHF that provides some 
or all of the following capabilities. 

RHF runs at a control point and contains an operator interface package, control tables, 
network application code, and the PP routines that drive the RHF network hardware. 

The following applications are also available as part of RHF: 
Application Description 



PTF, PTFS Permanent File Transfer Facility (PTF) and Permanent File Transfer 

Facility Servicer (PTFS). PTF and PTFS provide users access to remote 
permanent files. A local user activates PTF with the MFLINK 
command (refer to the NOS Version 2 Reference Set, Volume 3). When 
a remote user enters the MFLINK command, RHF activates a PTFS 
application on the local host to service the remote request. 

MHF Maintenance Host Facility (MHF). MHF automatically loads 

controlware of local NADs during RHF initiation and performs 
maintenance logging. If a local NAD fails while RHF is active, MHF 
automatically dumps the NAD's memory to a permanent file and 
reloads the controlware, for a description of LNAD statement 
parameters that control automatic NAD dumping and loading (refer to 
section 10, LID/RHF Configuration Files). 

MHF also periodically checks all local NADs and any remote NADs 
enabled for logging (refer to the network path table display described 
later in this section) and copies new NAD error log entries to the 
binary maintenance log (BML). 

MHF starts automatically when RHF is initiated and remains active 
until RHF terminates. 

QTF, QTFS Queue File Transfer Facility (QTF) and Queue File Transfer Facility 

Servicer (QTFS). QTF and QTFS allow you to transfer input and 
output files to a remote system. When RHF is initiated, the system 
automatically activates QTF. When a remote host QTF application has 
a file to transfer, RHF initiates QTFS on the local host to service the 
remote request. 

The following subsections describe the initiation, operation, control, and termination of the 
RHF. 
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RHF Initiation 

Before network operation can begin, you must initiate RHF using the DSD RHFflff 
command (refer to section 5, DSD Commands). 

When RHF is initiated, it starts all enabled applications defined by the network 
configuration as autostart applications (refer to RHF Configuration Files in section 10). 
These applications are typically MHF and QTF. 

Application MHF loads controlware into all local NADs that are defined in RHF's 
configuration with AUTOLOAD=YES and have an EST status of ON. 

Operator Interface 

The operator interface for RHF consists of using the following displays: 

Display Description 

Application table Lists all active applications. 

Network path Shows how the remote hosts are connected to the local host: 

table 

An example of each display is shown later in this section. To understand how to use the 
information provided in the displays it is helpful to understand the sample LCN network 
shown in figure 8-24. 
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Figure 8-24. Sample LCN 

MFA is the local NOS host and MFB, MFC, and MFD are the remote NOS hosts. MFA has 
four EST ordinals set up during installation (EST 31, 32, 33, and 34) to be used with the 
three remote hosts. Each NAD can connect to a maximum of four channels that can be used 
to communicate with NADs. These trunk control units (TCUs) are represented by the 
numbers 0, 1, 2, and 3 in the diagram (refer to A in figure 8-24). 

The horizontal lines between the NADs of the local mainframe (MFA) and the NADs of the 
remote mainframes (MFB, MFC, and MFD) depict the connections between the NADs. For 
example, the top horizontal line shows the connections between the channels starting at 
TCU of the local host and TCU 3 of the remote host (refer to B in figure 8-24). 

Also during the installation process, each remote NAD is given a remote NAD address to 
uniquely identify that particular NAD. For example, the remote host MFB has two NADs 
associated with it. Their remote NAD addresses are 3F and 4A (refer to C in figure 8-24). 
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RHF Commands Under K display 

Use the RHF K display to communicate with RHF. Bring up this display with this DSD 
command: 

K,RHF. 

Two K displays are available under RHF, the application table display (see figure 8-25) and 
the network path table display (see figure 8-26). When you first enter K,RHF, the 
application table display appears. The next time and subsequent times you enter K,RHF, 
the display that appears will be either the application table or the network path table, 
whichever was displayed last. 

The following commands are available under the RHF K display: 



Command 



Function 



APPL 
IDLE 

PATH 

ord,ND=rna,AC=rnac, 

DD=dd,RT=rteb, 

LT=lteb,LOG=status 



Displays the application table (see figure 8-25). 

Begins the idle-down process of RHF and all its associated 
applications. 

Displays the network path table (see figure 8-26). 

Modifies entries associated with the network path table display 
ordinal ord. 

Pages the current display forward. 
Pages the current display backward. 
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Application Table Display 

The application table display (see figure 8-25) lists all active applications. In this figure, 
USRAP represents an application written by the site. 
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Figure 8-25. Application Table Display 

Each entry in the display appears in the following format: 



ord appl 
j obname 



enabled 
j obord 



maxcopies 
connects 



activecopies maxconnects 



Header 



Description 



ord Application table display ordinal. 

appl Name of the application. 

enabled Specifies whether the application communicates with RHF. 

maxcopies Maximum number of copies of the application that can simultaneously 

communicate with RHF. 

activecopies Number of copies of the application that are currently communicating 
with RHF. 

maxconnects Maximum number of network connections allowed by each copy of the 
application. 

jobname Job sequence name of the application. 

jobord Executing job table ordinal of the application. 

connects Number of network connections currently used by this copy of the 

application. 
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Network Path Table Display 

The network path table display, illustrated in figure 8-26, shows how the remote hosts are 
connected to the local host. In this figure, A 1 means that a TCU is enabled. A means 
that a TCU is not enabled. The leftmost digit of these entries corresponds with TCU 0, the 
next with TCU 1, and so forth. For example, if a NAD has TCUs 1 and 2 enabled, the 
corresponding entry should be 0110. Refer to figure 8-24. 
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Figure 8-26. Network Path Table Display 
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Each entry in the display appears in the following format: 

ord pid est ch enabled local remote remote 

trunk trunk nad 
enables enables addr 



dest 



access 
code 



con log 
count errs 



Header Description 



ord 

pid 

est 

ch 

enabled 



local trunk 
enables 

remote 

trunk 

enables 

remote 
nad addr 

dest 

access 
code 

con count 

log errs 



Network path table display ordinal. 

Physical identifier of the remote mainframe for which the path is denned. 

EST ordinal of the NAD that defines the local end of the path. 

Channel number of the NAD that defines the local end of the path. 

Specifies whether RHF uses the path for starting new connections. For 
example, if a customer engineer wants to run diagnostics on a trunk 
connecting two NADs (local and remote), you would disable the appropriate 
path. When the connection count on that path falls to zero, the customer 
engineer can run concurrent diagnostics on that trunk without disturbing 
the operation of RHF. 

Bit pattern specifying which TCUs to use on the local NAD for 
communications with the remote NAD. 

Bit pattern specifying which TCUs the remote NAD uses in returning 
communications to the local NAD. 

Hardware address (hexadecimal) of the remote NAD. 

Destination device address (hexadecimal). 

Access code of the remote NAD; the software access code is the two leftmost 
characters and the hardware access code is the two rightmost characters. 

Number of connections currently using this path. 

Specifies whether the MHF application logs trunk errors (detected by the 
remote NAD) into the binary maintenance log (BML). 
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When the network path table is displayed, you can enter the following command to make 
changes. 

ord, ND=rna, AC=rnac , DD=dd, RT=rteb , LT=lteb , LOG=status . 

Parameter Description 

ord Network path table display ordinal. 

rna New remote NAD address in hexadecimal. 

rnac New remote NAD access code in hexadecimal. 

dd New remote NAD destination device address in hexadecimal. 

rteb New remote trunk enable bit pattern (nonzero 4-bit binary number with the 

leftmost bit representing TCU 0). 

lteb New local trunk enable bit pattern (nonzero 4-bit binary number with the 

leftmost bit representing TCU 0). The same number of bits must be set for 
both RT and LT or the command will be rejected. 

status Status of error logging for the specified remote NAD. Enter YES to have 

MHF periodically copy the trunk errors occurring on the specified remote 
NAD to the binary maintenance log (BML). MHF does not copy trunk errors 
when you enter NO. 

ord is the only required parameter and it must come first. All other parameters are optional 
and can appear in any order, but at least one, besides ord, must be present. 

NOTE 

Any change to rna, dd, or status for a given path results in an equivalent change for all 
paths using that remote NAD. This is because rna, dd, and status are associated with the 
remote NAD rather than the path to the remote NAD. 

When RHF finds a faulty local NAD, it turns off" the NAD's EST entry, activates the MHF 
application, and issues the following job dayfile message: 

RHF, NAD ON EST est HAS BEEN TURNED OFF 

MHF dumps the NAD's memory, reloads the NAD's controlware, and turns on the NAD's 
EST entry. 

When RHF finds a path configured to use a faulty or nonexistent local NAD trunk control 
unit (TCU), it disables the path and notifies you with the following message on the B,0 
display: 

RHF, BAD TCU ON PATH xxx, PATH TURNED OFF. 

Use the GO,RHF command to acknowledge the message. 
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RHF Commands Available Under Application or Network Path Display 

When the application table or network path table is displayed, you can enter the following 
commands to enable or disable the application or network path. 

ENABLE, ord. 

or 

DISABLE, ord. 

Parameter Description ^ 



ord Ordinal of the application or network path on the current display. 

For example, if the application table display is up, ENABLE,ord enables the application 
specified by the display ordinal ord. 

If an application is being enabled (whether currently enabled or disabled) and that 
application is defined as an autostart application, RHF initiates a copy of that application. 
This feature may be used, for example, if the MHF application is normally disabled and you 
want to start logging NAD errors. It may also be used if the copy of the QTF application 
has been dropped accidentally and a new copy of the QTF application must be started. 

RHF Termination 

You can terminate an RHF operation using the IDLE command. 
The command format is: 

IDLE. 

When you enter the IDLE command the system waits for applications to stop and the 
message IDLE-DOWN IN PROGRESS appears on the system status display. When activity 
stops, the system drops RHF and the message RHF ENDED appears. The IDLE command 
allows a gradual shutdown of RHF activities. No new connections are allowed. 



60459300 U K-Display Utilities 8-81 



SCOPE 2 Station Facility (SSF) K Displays 

SCOPE 2 Station Facility (SSF) K Displays 

The following commands control operation of the SSF Subsystem. 5 Initiate the SSF 
Subsystem before issuing any commands. SSF can be initiated automatically when the 
system is brought up, either manually by entering an SSFffff command, or by entering the 
ENABLE,SSF command. 

Operator Interface 

The SSF uses the K display for operator communications; therefore, the K display must be 
assigned to SSF before any other SSF Subsystem commands can be entered. Use the 
following command to assign the K display to SSF. 

K,SSF. 

Station Login 

After SSF is assigned to a control point, SSF searches the equipment status table (EST) for 
a SCOPE 2 communication coupler. If SSF finds an available coupler, it asks the SCOPE 2 
mainframe to establish communications. If no coupler is found, a message appears at the 
console indicating that SSF is ready to log in to a SCOPE 2 mainframe. To log in, first enter 
an ON command (refer to section 5, DSD Commands, for a description of the ON command), 
then enter the following command: 

K. LOGIN. 



Enabling and Disabling File Transfers 

File transfers between NOS and SCOPE 2 must be enabled before actual file transfers can 
begin; however, this occurs automatically when the SSF Subsystem is logged in. You can 
disable file transfers by entering the following command: 

K.OFFSTAT,x. 

Parameter Description ______^^__ 

x Specifies the SCOPE 2 mainframe PID. 

When you enter a K.OFFSTAT command, file transfers in progress are completed, but no 
new file transfers are initiated. This command does not affect command, display, or 
message processing. 

File transfers can be reenabled using the following command: 

K.ONSTAT,x. 

Parameter Description 

x Specifies the SCOPE 2 mainframe PID. 



5. Refer to appendix C for more information on the SSF Subsystem. 
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Station Recovery 

If NOS fails, follow the SSF initiation procedure as described in section 5, DSD Commands, 
to recover the station. SSF does not require reinitiation if SCOPE 2 fails or if there is an 
FLPP failure that results in a reload of the FLPP. 

Station Disconnection and Logout 

Station disconnection refers to the termination of communications between SSF and SCOPE 
2 as a result of a hardware or software error or as a result of an operator command. When 
the disconnection occurs, all pending requests to the SCOPE 2 mainframe (such as screen 
refreshes, messages, and acknowledgments) are dropped. 

Before entering an operator command to disconnect SCOPE 2, you should perform the 
following steps: 

1. Idle down the file transfers by entering the K.OFFSTAT command. The station is idle 
when all staging SPOT jobs are finished and the spooling SPOT job has been swapped 
out. 

2. If the system is in restricted or privileged mode, enter the CLROP command to 
relinquish operator control of SCOPE 2. Refer to the SCOPE 2.1 Operator's Guide for a 
description of the CLROP command. 

To disconnect the SCOPE 2 mainframe, you can either drop the station control point by 
issuing a STOP or IDLE Subsystem command as described in section 5, DSD Commands, or 
you can log out of a specific SCOPE 2 mainframe by using the following command: 

K. LOGOUT. 

or 

K. LOGOUT, pid. 

Parameter Description 



pid PID of the mainframe you want to disconnect (required only in a 

multimainframe environment). 
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File Transfer Limit Commands 

The following commands allow you to set limits on the number of file transfers that can be 
in progress concurrently for various types of file operations. The system default value for 
each of the following commands is 2; however, the default values can be changed, as an 
installation option, when SSF is installed. Refer to the NOS Version 2 Installation 
Handbook for more information on the default values for file transfer limit commands. 

Staged File Transfer Commands 

The following commands control the number of concurrent SPOT jobs performing staged file 
operations: 



Command 



Description 



K.PURGE,pid,n. 



K.READTP,pid,n. 



K.WRITETP,pid,n. 



KGETPF,pid,n. 



K.SAVEPF,pid,n. 



Specifies the maximum number of concurrent SPOT jobs allowed to 
purge files from a NOS permanent file device, pid is the PID of the 
SCOPE 2 mainframe, n is the maximum number of purge 
operations (0 < n< 7). 

Specifies the maximum number of concurrent SPOT jobs allowed to 
read tape files from NOS to SCOPE 2. pid is the PID of the SCOPE 
2 mainframe, n is the maximum number of read operations 
(0 < n < 7). 

Specifies the maximum number of concurrent SPOT jobs allowed to 
write tape files from SCOPE 2 to NOS. pid is the PID of the SCOPE 
2 mainframe, n is the maximum number of write operations 
(0 < n < 7). 

Specifies the maximum number of concurrent SPOT jobs allowed to 
read permanent files from NOS to SCOPE 2. pid is the PID of the 
SCOPE 2 mainframe, n is the maximum number of permanent file 
read operations (0 < n < 7). 

Specifies the maximum number of concurrent SPOT jobs allowed to 
write files from SCOPE 2 to a NOS permanent file device, pid is the 
PID of the SCOPE 2 mainframe, n is the maximum number of 
permanent file write operations (0 < n < 7). 
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Spooled File Transfer Commands 

The following commands control the number of I/O files that the spooling SPOT job xSTA 
can transfer concurrently. Separate limits can be defined for both input and output files; 
however, the system limits the combined total of input and output files to four concurrent 
transfers. 



C omman d Description 

K.INPUT,pid,n. Specifies the maximum number of concurrent input file transfers 

from NOS terminals to SCOPE 2. pid is the PID of the SCOPE 2 
mainframe, n is the maximum number of input files (0 < n < 4). 

K.OUTPUT,pid,n. Specifies the maximum number of concurrent output file transfers 
from SCOPE 2 to NOS terminals, pid is the PID of the SCOPE 2 
mainframe, n is the maximum number of output files (0 < n < 4). 
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Transaction Facility (TAF) K Displays 

The following commands control operation of the TAF Subsystem. Initiate the TAF 
Subsystem by using the TAFflff* command before issuing these commands. 

TAF Initialization K Display 

When the transaction executive is brought to a control point, the message 
REQUEST *K* DISPLAY appears at the control point if a DISPLAY,ON command is 
specified in the TAF configuration file. Respond with the entry: 

K,TAF. 

The TAF initialization K display appears on the system console as shown in figure 8-27. 



K. TAF 

hh.mm.ss. yy/mm/dd. CDC NETWORK OPERATING SYSTEM 
MID=AA NOS version 

TAF INITIALIZATION OPTIONS 



DESCRIPTION 

SUB CONTROL POINTS (2 - 31) . 
COMMUNICATION BLOCKS (19 - 40). 
RECOVERY MODE (YES OR NO) . 
MAXIMUM FIELD LENGTH (40000B - 376500B) . 
EXTENDED MEMORY FIELD LENGTH (OK - 400K) . 
TASK LIBRARY FILE (1-7 CHARACTERS). 

INITIALIZE CRF RECOVERY FILES (NONE, ALL OR 
1-7 DIGITS) . 

INITIALIZE CRM RECOVERY FILES (NONE OR ALL) 
ERROR OVERRIDE (YES OR NO) . 

CMM BASE FL (20000B - 200000B) . 
CMM EXPANDABLE FL (0 - 100000B) . 
CMM TARGET FL (10000B - 100000B) . 
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Figure 8-27. TAF Initialization E Display (Left Screen) 
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Any of the following initialization commands can then be entered. If no values are to be 
changed, enter the command: 

K.END 

Values are decimal unless otherwise indicated. 



Command 



Description 



Changes the starting and minimum field length allocated by TAF to 
CEM (20000 8 < n < 200000 8 ). Default is 70000 8 . 

Changes the maximum number of communication blocks allowed to the 
TAF Subsystem (19 < n < 40). Default is 40. 

Sets the extended memory field length to be used by the transaction 
executive; n is octal thousands of words. Default is 0. 

Changes the maximum additional central memory field length made 

available to CRM for buffers and capsules (0 < n < 100000 8 ). Default is 

0. 

Ends input of the transaction executive initialization parameters. 

Initialization is completed when the TAF status K display appears 

(figure 8-28). 

KERO=CRF,op Specifies whether to override certain I/O and logic errors when 
processing the communication recovery files (CRF). 



K.BFL=n 



K.CMB=n 



KECS=n 



KEFL=n 



K.END 



op_ 



Description 



NO Aborts if I/O or logic errors are encountered while processing 

the communication recovery files. This is the default setting. 

YES I/O or logic errors encountered on a run unit header record 

result in the loss of that run unit with no indication to the 
terminal user. The loss is noted on the recovery report. 

I/O or logic errors encountered on a message record within a 
run unit result in a loss of that run unit. A status field is set 
in the run unit header, allowing TAF to inform the terminal 
user of the run unit loss. 

I/O or logic errors encountered on the CRF header record 
result in an unconditional abort of the TAF Subsystem. 
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Command 



Description 



K.GO 



Ends input of the transaction executive initialization parameters. 
Initialization is complete when the TAF status K display appears 
(figure 8-28). 



KINT=typ,fileid Specifies which communication recovery files (CRF) are to be 

initialized. This is the only way to initialize a CRF. Files specified on a 
RECOVER command in the TAF configuration file and specified in this 
command are initialized. Files specified on a RECOVER command but 
not specified in this command are used for recovery. 

This command also specifies whether CYBER record manager (CRM) 
data base recovery files are initialized or recovered. For CRM recovery 
files, this command is valid regardless of TAF assembly parameters. 

typ Description 



CRF 
CRM 
fileid 



Communication recovery files. This parameter is valid only if 
the installation parameter IPTAR equals 1. 

CYBER Record Manager after-image and before-image 
recovery files. 

Description 



n A digit from 1 to 7 that defines a CRF to be initialized. The 

digit corresponds to the ID parameter on the RECOVER 
command in the TAF configuration file. This parameter is not 
valid for CRM recovery files. 

ALL If typ is CRF, all communication recovery files defined by 

RECOVER commands in the TAF configuration file are 
initialized. If typ is CRM, all CRM recovery files are 
initialized. 

This parameter must be used with caution when typ is CRM 
since the CRM update history currently on the after-image 
recovery files is lost. 

NONE If typ is CRF, communication recovery files are initialized; all 
communication recovery files specified in RECOVER 
commands in the TAF configuration file are recovered. If typ 
is CRM, all CRM data bases are recovered based on 
information in the existing recovery files. No CRM recovery 
files are initialized. This fileid is the default for both 
typ=CRF and typ=CRM. 
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Command 



Description 



KMFL=n 



Sets the maximum field length to be used by the transaction executive 
(40000 8 < n < 376500 8 ). Default is 376500 8 . 

Specifies whether to set the recovery bit in the user area of each 
terminal status table entry (YES or NO). If YES, the user recovery bit 
is set. If NO, the value of the user recovery bit is not changed from 
what it was before the command was issued. Default is NO. 

Changes the number of subcontrol points (2 < n < 31). Default is 31. 

Aborts the TAF Subsystem initialization unconditionally. 

Changes the value used as the upper bound for TARGET. This is the 
amount of memory CRM uses for data and index blocks 
(10000 8 < n < 100000 8 ). Default is 30000 8 . For more information, refer 
to the CYBER Record Manager Advanced Access Methods Version 2 
Reference Manual. 

K.TLF=filename Changes the name of the system task library file (any valid file name). 
Default is TASKLIB. 



K.REC=a 



KSCP=n 

KSTOP 

KTFL=n 
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Restarting TAF K Display 

On a level 3 recovery deadstart, or if the TAF Subsystem aborts, the TAF procedure file will 
automatically restart TAF by transferring control to the TAF automatic recovery program, if 
sense switch 4 is set. The TAF automatic recovery program recovers the central memory 
pointers and variables denned during TAF initialization. 

If a DISPLAY,ON command is in the TAF configuration file, the automatic recovery 
program brings up the K display on the left console screen. This display is identical to the 
TAF initialization K display, except that values specified by the TAF initialization 
commands replace any default values that were in the TAF initialization K display. 

TAF Status K Display 

When the TAF Subsystem is executing, the TAF status K display (figure 8-28) indicates the: 

• Latest transaction sequence number. 

• Number of words of unused memory. 

• Maximum field length. 

• Global task dump limit. 

• Subsystem default values for memory dump parameters. 

The subsystem default values are used to control memory dumps when parameters are not 
included in the CMDUMP or DSDUMP command. Any of these default values can be 
changed by specifying the corresponding parameter in the KDSDUMP command. 



K. 






TAF 




hh.mm. ss. 


yy/mm/dd. 


CDC NETWORK OPERATING 


SYSTEM 








MID=AA NOS version 










TAF STATUS 








TRANSACTION SEQUENCE NUMBER 


5 






UNUSED 


FIELD LENGTH 


7700 






MAXIMUM FIELD LENGTH 


376000 






GLOBAL 


TASK DUMP LIMIT 









CMDUMP/DSDUMP DEFAULT VALUES 




OPTION 


DESCRIPTION 


FW 


= 




FWA OF TASK MEMORY TO 


BE DUMPED. 


LW 


= 100000 


LWA OF TASK MEMORY TO 


BE DUMPED. 


EP 


= 1 




IF EP=1, DUMP EXCHANGE PACKAGE. 

IF EP=0, DO NOT DUMP EXCHANGE PACKAGE. 


OQ 


= BC 




OUTPUT QUEUE. 




QD 


= 




QUEUE DESTINATION. 





Figure 8-28. TAF Status K Display (Left Screen) 
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The default parameter values for the CMDUMP and DSDUMP commands are given on the 
TAF status K display shown in figure 8-28. 

Parameter Descrip tion ^ 

EP Exchange package: 

EP Description ______ 

Do not dump the exchange package. 

1 Dump the exchange package. 

FW First word address of the task memory to be dumped. 

LW Last word address of the task memory to be dumped. 

OQ 6 Output queue: 

OQ Description 

BC Local batch. 

R6 Remote batch. 

PF Permanent file. 

QD 6 Queue destination: 

Printer identifier (if OQ=BC). 
User name (if OQ=RB). 
Permanent file name (if OQ=PF). 



6. The functioning of this parameter is described in the TAF Version 1 Reference Manual. 
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TAF K-Display Commands 



When the transaction executive is at its control point, the following commands can be 
entered from the system console or submitted from tasks using the KPOINT request. Any 
task can issue the KDUMP command. Only tasks that reside on the system task library 
can issue the other K-display commands. (Eefer to the TAF Version 1 Reference Manual for 
additional information on the KPOINT request and the system task library.) 



C omman d 



Description 



K.ASSIGN,est 

or 

KASSIGN,est,db,n 



K.DEBUG 

KDROP,n 

KDSDUMP,FW=addr, 
LW=addr,EP=pkg, 
OQ=outq,QD=qdest, 
DB=db 



Assigns a magnetic tape unit to be used for a journal file, est is 
the EST ordinal of the tape unit. The first form of the 
command makes unit est available for the transaction executive 
to assign to the next tape journal file that encounters end of 
reel. Two tape units may be preassigned. If a tape has not been 
preassigned in this manner, an end-of-reel on a journal file 
causes subsequent entries for that file to be placed on disk. 

The second form of the command forces journal file n (n=l, 2, or 
3) for data base db, defined as a tape file, from disk to tape. The 
transaction executive copies the data from the disk journal file 
to tape est and places all subsequent entries for that file on the 
tape. This command is necessary after the transaction executive 
initialization to assign tape units to the tape journal files or 
after an end-of-reel on a tape journal file when no tape had been 
preassigned to the transaction executive. All data residing on 
the disk for the tape journal file must fit on the tape assigned 
by this command or the transaction executive will unload the 
tape and issue the message *UNABLE TO USE TAPE*. 

Turns on the application interface program (AIP) debug option, 
which logs all messages on trace file ZZZZZDN. Use this 
command only when TAF is installed with the DEBUG option. 

Drops an executing task at subcontrol point n. 

Allows you to modify the standard system default parameters 
controlling memory dumps. The command does not directly 
cause a dump. Rather, it sets default values to be used when a 
subsequent CMDUMP request is received or when abort 
conditions occur. Refer to TAF Status K Display, earlier in this 
section, for explanations of the parameters. 
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Command 



Description 



KDUMP,fwa,lwa 



Dumps all or part of the field length of the Transaction Facility 
from the first word address (fwa) to the last word address (lwa) 
of the area to be dumped. The default value for fwa is and for 
lwa is 377777 8 . The default base is octal. If no parameters are 
specified, the entire field length is dumped. The output is 
routed to a printer that has an ID of 0. 

Unlike other K-display commands, the KDUMP command can 
be issued from any task. Other K-display commands can be 
issued by tasks only if they are on the system task library 
(refer to the TAF Version 1 Reference Manual). 

Since secure information may be contained in a dump of the 
Transaction Facility, the following safeguards have been set up 
to protect dumped information; however, the installation must 
take the ultimate responsibility for the protection of dumped 
information. 

• The global task dump limit (GTDL) can be set by the 
K.DUMPLIM command to limit the number of times the 
KDUMP command can be issued from tasks. The initial 
value of the GTDL is (zero), so the KDUMP command is 
disabled from use by a task by default. 

• For all dumps of the Transaction Facility , whether you 
initiated it or a task did, a one-page header precedes the 
dump. This header page indicates the output is secure and 
should be given only to the TAF central site systems 
analyst. 

• When the Transaction Facility is dumped, the message 
TAF FIELD LENGTH DUMP RELEASED is issued to the 
system dayfile, the Transaction Facility dayfile, and line 
one of the control point. 
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Command 



Description 



KDUMPLIM,n 



KIDLE 



KJEND,db,n 



KMAXFL,n 



KMESSAGE,TN=b. 
message 



Sets GTDL to value n (0 < n < 9999999). If n is not specified, 
the GTDL is set to 0. 

The GTDL is the number of times the KDUMP command can 
be issued from tasks. This value is displayed on the TAF status 
K display shown in figure 8-28. The initial value of the GTDL 
is 0. When the GTDL is 0, no dumps of the Transaction Facility 
can occur from tasks. Thus, the KDUMP command is disabled 
from tasks by default. 

To enable the KDUMP command for tasks, issue the 
KDUMPLIM command to set the GTDL to a value greater 
than zero. Each time a task issues a KDUMP command, the 
GTDL is decreased by one until it equals zero. When the first 
KDUMP command is issued from a task with the GTDL equal 
to zero, the message 

GLOBAL TASK DUMP LIMIT EXHAUSTED 

is issued to the Transaction Facility dayfile, the system dayfile, 
and line one of the control point. Also, the message 

DUMPS LOST 

is displayed on the K display in place of the value of the GTDL. 
This message remains until the value of GTDL is set to a value 
greater than or equal to zero. The KDUMPLIM command 
should be used with care in system tasks, since this might 
allow unauthorized users to alter the GTDL. 

Idles down the transaction control point. Once idle down has 
been initiated, no new transactions will be permitted but 
currently executing transactions will be allowed to finish. 

Forces end-of-reel processing (writes an EOI and rewinds the 
file) on tape journal file n of data base db. If n is not a tape 
journal file, the command is ignored. 

Alters the transaction executive maximum field length. The 
transaction executive does not attempt to obtain more than n 
words of storage. This command is rejected if the value for n is 
more than 376500 8 or less than the field length currently 
required for TAF. 

Directs the transaction executive to send message to a terminal 
specified by terminal name b. 
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Command 

K.NODEBUG 



KOFFTASK,a,db 



KONTASKa,db 



KROLLTIM,iiBniinn 



KSWITCH 



Description 



KTBCOKnn 



KTST,TN=a,DB=db, 
UU=nnnn,TJL=TTiTTiTTiTn , 
NN=b 



Turns off the application interface program (AIP) debug option, 
which logs all messages on trace file ZZZZZDN. Use this 
command only when TAF is installed with the DEBUG option. 

Disables the use of task a, where a is the task name in the data 
base db task library directory (dbTASKL). The data base name 
db is not specified for tasks in the system task library. 

Reverses the effect of a previous OFFTASK command for the 
specified task a in the data base db task library directory 
(dbTASKL). The data base name db is not specified for tasks in 
the system task library (TASKLIB). 

Changes the amount of time that TAF will retain its field 
length between communication input messages; nnnunn is 
specified in units of milliseconds. Refer to the installation 
parameter ITRTL in the NOS Version 2 Installation Handbook. 

Causes the console K display to change to a display listing all 
allowable TAF K display commands. When KSWITCH is 
entered a second time, the previous K display returns. This 
command activates task KDIS and forces TAF to remain rolled 



in. 



Changes the number of TAF/CRM batch concurrency users; nn 
is less than or equal to the value specified on the TBCON 
command in TAF's configuration file (TCF). 

Changes entries in the terminal status table for terminal a. 
The following entries can be changed: data base name db, user 
area upper 12 bits (nnnn), user area lower 12 bits (mmmm), 
and new terminal name b. The changes do not affect the 
network and simulation files. Do not use this command if the 
terminal is logged in. 
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TAF/CRM Status K Displays and Commands 

You can use the K display to monitor the status of CRM, CRM data bases, or CKM data 
base permanent files while TAF/CRM is running if CRMTASK is present on the system task 
library. To get the CRMTASK K display enter: 

K.DIS, CRMTASK. 

After the K display is assigned to the task, the display in figure 8-29 is brought to the left 
screen. 



K. TAF 

hh.mm.ss. yy/mm/dd. CDC NETWORK OPERATING SYSTEM 
MID=AA NOS version 



CRMSTAT 
CRMSTAT, DB 
CRMSTAT, DBPFN 

DBDOWN,DB 
DBDOWN, DBPFN 
DBUP,DB 
DBUP, DBPFN 

END 
MENU 

+ 



CRMTASK COMMANDS 

SEE ALL CRM DATA BASES. 

SEE CRM DATA BASE DB. 

SEE CRM DATA BASE FILE DBPFN. 

DOWN DATA BASE DB. 

DOWN DATA BASE FILE DBPFN. 

UP DATA BASE DB. 

UP DATA BASE FILE DBPFN. 

END CRMTASK PROCESSING. 
SEE THIS DISPLAY. 
PAGE LEFT SCREEN FORWARD. 
PAGE LEFT SCREEN BACKWARD. 



Figure 8-29. CRMTASK Commands K Display (Left Screen) 
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The following commands are available under CRMTASK 



Command 



Description 



KCRMSTAT 
KCRMSTAT,db 



Selects the CRM status K display (figure 8-30). This display shows 
the status of all CRM data bases. 

Selects the CRM data base status K display (figure 8-31). This 
display shows the status of the specific CRM data base with identifier 
db. It also shows the file name and status of the before-image files. 

KCRMSTAT.dbfile Selects the CRM file status K display (figure 8-32). This display 

shows the status of the specific permanent file in a CRM data base 
with file name dbfile. 

KDBDOWN,db Makes a specific CRM data base with identifier db unavailable for 
processing. When this command executes, the CRMTASK command 
directory appears on the K display. 

KDBDOWN,dbfile Makes a specific permanent file in a CRM data base with file name 
dbfile unavailable for processing. When this command executes, the 
CRMTASK command directory appears on the K display. 



KDBUP,db 

KDBUP,dbfile 

KEND 
KMENU 
K+ 
K- 



Makes a specific CRM data base with identifier db available for 
processing. When this command executes, the CRMTASK command 
directory appears on the K display. 

Makes a specific permanent file in a CRM data base with file name 
dbfile available for processing. When this command executes, the 
CRMTASK command directory appears on the K display. 

Ends CRMTASK K-display processing. 

Returns to the CRMTASK commands K display (figure 8-29). 

Pages the left screen forward to the next screen. 

Pages the left screen backward to the first screen. 
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K. 




TAF 








hh.mm.ss. 


yy/mm/dd. 


CDC 


NETWORK OPERATING 


SYSTEM 








MID= 


=AA 

CRM 


NOS version 
STATUS 








TRANSACTIONS IN 


INPUT QUEUE 


= 







ACTIVE TRANSACTIONS = 




1 




TRANSACTIONS IN 


OUTPUT QUEUE 


= 





DATA 






DATA 




DATA 




BASE 


STATUS 




BASE 


STATUS 


BASE 


STATUS 


TT 


UP 




BA 


UP 


BB 


UP 


BC 


UP 




BD 


UP 


BE 


UP 


BF 


IDLE 




BG 


UP 


BH 


UP 


BI 


UP 




BJ 


IDLE 


CA 


UP 


CB 


UP 




CC 


UP 


CD 


UP 


CE 


DOWN 




CF 


UP 


CG 


DOWN 


CH 


UP 




CI 


DOWN 


CJ 


UP 



Figure 8-30. CRM Status K Display (Left Screen) 



K. 




TAF 




hh.mm. ss . 


yy/mm/dd 


CDC NETWORK OPERATING SYSTEM 
MID=AA NOS version 




DATA BASE NAME = 


AB AFTER IMAGE FILE = 


ZZABA01 


DATA BASE STATUS 


= UP PRU-S REMAINING = 


20 




BI 










FILE 


STATUS 


FILE STATUS FILE 


STATUS 


ZZABB01 


UP 


ZZABB02 UP ZZABB03 


UP 


ZZABB04 


DOWN 


ZZABB05 UP ZZABB06 


DOWN 


ZZABB07 


UP 










FILE 


STATUS 


FILE STATUS FILE 


STATUS 


ABPFN01 


UP 


ABPFN02 UP ABPFN03 


IDLE 


ABPFN04 


UP 


ABPFN05 DOWN ABPFN06 


UP 


ABPFN07 


UP 


ABPFN08 UP ABPFN09 


UP 


ABPFN10 


DOWN 


ABPFN11 UP ABPFN12 


UP 



Figure 8-31. CRM Data Base Status K Display (Left Screen) 
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K. TAF 

hh.mm.ss. yy/nim/dd. CDC NETWORK OPERATING SYSTEM 

MID=AA NOS version 

CRM FILE STATUS 

FILE NAME = TTRNFDM 
FILE STATUS = UP 
RECOVERABLE = YES 

PACK NAME = PACKNAM 
DEVICE TYPE = DEFAULT 
ATTACH MODE = M 

SIZE OF PRIMARY KEY = 30 
NUMBER OF ALTERNATE KEYS = 6 

ACTIVE USERS = 4 
ACTIVE LOCKS = 8 



Figure 8-32. CRM File Status K Display (Left Screen) 
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FOTD L Display 9-2 

LIDOU L Display 9-3 

QDSPLAY L Display 9-6 

SCTD L Display 9-9 

SDSPLAY L Display 9-11 

SDSPLAY Commands 9-16 

Changing System Attributes 9-17 

L.keyword=value Commands 9-17 

SUBSYST L Display 9-19 



60459300 U 



L-Display Utilities 9 

This section documents the following L displays and the utilities used to present them. 
Utility Description 



FOTD Displays family ordinal table (FOT). 

LIDOU Displays logical identifier table (LID). 

QDSPLAY Displays the contents of a file in the queued file table (QFT). 

SCTD Displays the contents of the service class control table, which shows the 

valid service classes for each origin type. 

SDSPLAY Displays system values used to control job flow. 

SUBSYST Displays subsystem information. 

The L display is like the K display in that you must start the program by entering the name 
of the utility. When the L display is ready for use, DSD assigns it to the left screen 
automatically. Only one L-display program is active at a time. The program need not 
occupy a control point or memory while you are looking at the display. 

Using the L display, you can run any utility program you have created. The L display is an 
interface between your program and DSD. This interface allows the site analyst to write 
CPU programs that show displays on the system console. 

All entries must be prefixed by L period (L.). However, when pressing CR or NEXT after 
the first entry, everything but the L. is erased. This allows another command to be entered 
without entering L. first. All examples in this section show L., although you may not have 
to type it. If it becomes necessary to enter a DSD command during parameter entry, simply 
backspace to erase the L., enter the command, and then continue by typing L. and the entry. 

After you call a specific utility, enter the first command in the following format: 

L . commands tring . 

Parameter Description 



commandstring Any input (command, data, or parameter) that is defined by the job as 
valid input. 

Execute your own L-display utility by entering the following command: 

LDISopt . 

Parameter Description ^^^ 



opt One to three characters defining your utility. 
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FOTD L Display 

The FOTD L-display utility displays all the family names known to the system and the 
corresponding family ordinal. To initiate the FOTD utility enter one of the following 
commands: 

FOTD, L=outf ile , LO=option. 
or 

FOTD, outf ile, option. 

Parameter Description 

outfile Output file name. This parameter is valid only if a list option is 

specified. The default outfile is file OUTPUT. 

option List option. Enter one or more of the following: 

option Description 

D Formats the data for the DSD L display. This is the default 

list option if the parameters outfile and option are not 
specified. 

L Formats the data for a line printer. 



If you do not specify outfile and option, the data is written to the L-display buffer once and 
the utility ends. 

Figure 9-1 shows the FOTD L display. 



L . FOTD 
hh.mm.ss. yy/inm 


'dd. CDC NETWORK OPERATING SYSTEM 
MID=AA NOS version 




FAMILY ORDINAL 


TABLE DISPLAY 




DEFAULT FAMILY = FAMILYl 


AVAILABLE ENTRIES = 4B 


ORD. FAMILY 


ORD. FAMILY 


ORD. FAMILY 


ORD. FAMILY 


1. FAMILYl 

5. FAMILY5 

11. FAMILY9 


2. FAMILY2 

6. FAMILY6 

12. FAMIL10 


3. FAMILY3 

7. FAMILY7 

13 . FAMILll 


4. FAMILY4 
10. FAMILY8 
14. FAMIL12 



Figure 9-1. FOTD L Display 

The FOTD L display contains the default family name and the octal number of FOT entries 
that remain available for assignment. The display also shows each family name and its 
corresponding family ordinal. 
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LIDOU L Display 

The LIDOU utility displays the LID table configuration and allows you to add or delete 
LIDs, LID attributes, and PID attributes in the LID table configuration. This modified 
configuration is retained across a level 1, 2, or 3 recovery deadstart. A level deadstart 
causes a return to the configuration defined by the LID configuration file. 

To initiate the LIDOU utility, enter one of the following commands: 

LIDOU . 
or 

LIDOU , I=inf ile , L=outf ile . 

The first command format can be entered only from the console under DSD control; also, all 
input and output is processed using the LIDOU L display. Figure 9-2 shows the initial 
LIDOU L display (LID display). 



NOTE 



The information shown in figure 9-2 corresponds to the sample LCN shown in section 8. 



From this display you can select the HELP display shown in figures 9-3 and 9-4. You can 
toggle between these two L displays as described in the HELP display. 

The second command format can be entered under DIS control or by a system origin batch 
job. In either case, the I and L parameters must be specified. 

Parameter Description 



I=infile LIDOU reads input directives from file infile. Valid input directives are 

the same as the commands shown in the HELP L display (figure 9-3) 
without the L. prefix and without the BACK, HELP, +, or - commands. 

L=outfile LIDOU writes output to file outfile. 
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L . LIDOU 
hh.mm.ss. yy/mm/dd. CDC NETWORK OPERATING SYSTEM 

MID=AA NOS version 



PID 
MFB 

MFC 
MFD 



LID ENABLED ATTR 
H-V- 



MBF 
BBB 
XYZ 



MFC 
CCC 



MFD 
DDD 
EEE 
BBB 



YES 
YES 
YES 
YES 

YES 
YES 
YES 

YES 
YES 

NO 
NO 
YES 



S 

S 

-L — 

S--N 

-LVN 

S 

S 

S 



MFTYPE 
NOS 

NOS 
NOS 



NETWORK STATUS 
RHF IN SERVICE 

RHF IN SERVICE 
SSF IN SERVICE 



Figure 9-2. LIDOU L Display (LID) 



L . LIDOU 

hh.mm.ss. yy/mm/dd. CDC NETWORK OPERATING SYSTEM 
MID=AA NOS version 



LID OPERATOR UTILITY HELP DISPLAY 



PAGE 1 OF 2 



COMMAND 

L.END 

L . BACK 

L.HELP 

L.+ 

L-- 

L.OUT 

L.PID,PA=XXZ 

L . PID , NT=NNN , NA= Z 

L - PID, LD=LID, LA=YYYZ 

L . PID, LD=LID, DELETE 

L . PID , MF=MAINFRM 



DESCRIPTION 



TERMINATE LIDOU 

FORMAT LID DISPLAY 

FORMAT HELP DISPLAY 

PAGES THE L DISPLAY FORWARD 

PAGES THE L DISPLAY BACKWARD 

ROUTES A LISTING OF THE LID TABLE 

SET ALL APPLICABLE PID ATTIBUTES 

ENABLE/DISABLE NETWORK STATUS 

ADD OR SET ATTRIBUTES FOR LID 

DELETE LID FROM LID TABLE 

SET MAINFRAME DESCRIPTION 



X CAN BE V OR N. Y CAN BE S, B, V OR N. Z CAN BE E OR D. 
ALL COMMANDS CAN BE ENTERED FROM THE HELP OR LID DISPLAY 
ENTER L.+ FOR MORE HELP (COMPLETE ATTRIBUTE DESCRIPTIONS) 



Figure 9-3. LIDOU L Display (HELP) (Page 1 of 2) 
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L. LIDOU 
hh.mm.ss. yy/mm/dd. CDC NETWORK OPERATING SYSTEM 

MID=AA NOS version 



LID OPERATOR UTILITY HELP DISPLAY 

ATTRIBUTE DESCRIPTIONS 

S - STORE AND FORWARD 

B - LOOPBACK 

V - VALIDATE 

D - DISABLE 

E - ENABLE 

N - NOLIST 

PARAMETER DESCRIPTIONS 



PID IS THE THREE CHARACTER PHYSICAL IDENTIFIER 

LID IS AN ASSOCIATED THREE CHARACTER LOGICAL IDENTIFIER 

X CAN BE V OR N. Y CAN BE S, B, V OR N. Z CAN BE E OR D. 

MAINFRM IS A (ONE TO SEVEN CHARACTER) MAINFRAME DESCRIPTOR 

NNN IS THE NETWORK (*RHF*, *SSF*, *NAM* , OR *ALL* ) 

ENTER L.- TO SEE THE AVAILABLE COMMANDS 



PAGE 2 OF 2 



LIDS FOR LINKED PIDS ONLY. 
LIDS FOR HOST PIDS ONLY. 
NOTE THAT S AND B CANNOT 
BE SPECIFIED TOGETHER AND 
ALSO THAT E AND D CANNOT 
BE SPECIFIED TOGETHER. 



Figure 9-4. LIDOU L Display (HELP) (Page 2 of 2) 

Although not shown in the HELP L display, some or all PID characteristics can be changed 
with one command by including all of the appropriate parameters on that command. For 
example, all PID characteristics for a given PID can be changed with the following command: 

L.pid, PA=xxz,MF=mainfrm,NT=nnn,NA=z. 
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QDSPLAY L Display 

The DSD utility QDSPLAY displays the content of a queued file listed in the queued file 
table (QFT). ASCII8 files are automatically translated into display code before they are 
displayed. 



NOTE 



On a secured system, the console must be in security unlock status to accept this command 
(refer to the UNLOCK,username,password command in section 5). 



To bring the QDSPLAY L display to the left console screen, enter the following command: 

QDSPLAY, jsn. 

Parameter Description 



jsn 



Job sequence name of the queued file you want to examine. 



Figures 9-5 and 9-6 show the initial QDSPLAY L display. 



L. QDSPLAY 
hh.mm.ss. yy/itim/dd. CDC NETWORK OPERATING SYSTEM 

MID=AA NOS version 



QDSPLAY COMMANDS 
COMMAND 



PAGE 1 OF 2 



DESCRIPTION 



BACK 
BOI 
DAY 
DROP 

END 
HELP 
LINE 
OCTAL 

SS 



RETURN FROM HELP/SS TO PREVIOUS FILE DISPLAY. 
POSITION FILE TO BOI AND DISPLAY DATA. 
POSITION PRINT FILE TO DAYFILE AND DISPLAY DATA. 
DROP FILE FROM QUEUE AND TERMINATE. 

RETURN FILE TO QUEUE AND TERMINATE. 

LIST L DISPLAY COMMANDS FOR QDSPLAY UTILITY. 

SET FILE DISPLAY MODE TO LINE FORMAT. 

SET FILE DISPLAY MODE TO OCTAL FORMAT. 

DISPLAY IN OCTAL FROM BEGINNING OF SYSTEM SECTOR. 
PAGE DISPLAY FORWARD (CIRCULAR FOR SS) . 
PAGE DISPLAY BACKWARD. 



Figure 9-5. Initial QDSPLAY L Display (Page 1 of 2) 
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L . QDSPIAY 
hh.mm.ss. yy/mm/dd. 



QDSPLAY COMMANDS 



COMMAND 



CDC NETWORK OPERATING SYSTEM 
MID=AA NOS version 



PAGE 2 OF 2 



DESCRIPTION 



SL SKIP 1 LINE FORWARD IN FILE AND DISPLAY DATA. 

SL,N SKIP N LINES FORWARD IN FILE AND DISPLAY DATA. 

SP SKIP 1 PAGE FORWARD IN FILE AND DISPLAY DATA. 

SP,N SKIP N PAGES FORWARD IN FILE AND DISPLAY DATA. 

SR SKIP 1 RECORD FORWARD IN FILE AND DISPLAY DATA. 

SR,N SKIP N RECORDS FORWARD IN FILE AND DISPLAY DATA. 

SR,* SKIP TO EOI IN FILE. 

BR SKIP 1 RECORD BACKWARD IN FILE AND DISPLAY DATA. 

BR,N SKIP N RECORDS BACKWARD IN FILE AND DISPLAY DATA. 



Figure 9-6. Initial QDSPLAY L Display (Page 2 of 2) 

Valid QDSPLAY commands are: 
Command Description 



L.BACK 

L.BOI 
L.BR,r 



L.DAY 

L.DROP 
L.END 
L.HELP 
KLINE 



Returns from the L.SS or L.HELP command displays and displays the 
contents of the file at the current position. This command is ignored if 
you are already displaying the contents of the file. 

Positions the file to the beginning-of-information (BOI) and then displays 
the data from that point. 

Skips backward r records in the file and displays the data from the 
beginning of that record. If r is not specified, the default is one record. 
The record count, r, is decimal unless a B postradix is specified to make 
the number octal. The maximum skip count is 377777 8 . A BOI 
terminates the skip regardless of the number of records specified or 
skipped. This command is not allowed when the HELP display or system 
sector is being displayed. 

Positions the print file to the beginning of the dayfile record and displays 
the data from that point. 

Drops the file from the queue and terminates the QDSPLAY utility. 
Returns the file to the queue and terminates the QDSPLAY utility. 
Lists the L display commands for the QDSPLAY utility. 

Sets the file display mode to line format (not allowed when displaying the 
system sector). 
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Command Description 



L. OCTAL 
L.SL,n 



L.SP,p 



L.SR,r 



L.SS 

L.+ 
L.- 



Sets the file display mode to octal format. 

Skips n lines forward in the file and displays the data from the beginning 
of that line. If n is not specified, the default is one line. The line count, n, 
is decimal unless a B postradix is specified to make the number octal. 
The maximum skip count allowed is 377777 8 . A fine can be up to 14 
words. An EOR, EOF, or EOI ends the skip regardless of the number of 
fines specified or skipped. This command is allowed only when displaying 
data in line format and is not allowed when the HELP display or system 
sector is being displayed. 

Skips forward p pages in the file and displays the data from the be ginning 
of that page. If p is not specified, the default is one page. The page count, 
p, is decimal unless a B postradix is specified to make the number octal. 
The maximum skip count allowed is 377777 8 . A page is based on a 
carriage control 1 as the first character in a line. An EOR, EOF, or EOI 
ends the skip regardless of the number of pages specified or skipped. The 
command is allowed only when displaying data in fine format and is not 
allowed when the HELP display or system sector is being displayed. 

Skips forward r records in the file and displays the data from the 
beginning of that record. If r is not specified, the default is one record. If 
an asterisk (*) is specified for the record count, r, a skip forward to the 
EOI occurs. The record count, r, is decimal unless a B postradix is 
specified making the number octal. The maximum skip count allowed is 
377777 8 . An EOI ends the skip regardless of the number of records 
specified or skipped. This command is not allowed when the HELP 
display or system sector is being displayed. 

Displays the data from the beginning of the system sector in octal display 
code format. 

Pages the QDSPLAY, HELP, or SS display forward. 

Pages the HELP display backward. 
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SCTD L Display 

The service class control table L-display (SCTD) utility displays the contents of the service 
class control table (SCT). To begin the SCTD utility, enter one of the following commands: 

SCTD , L=outf ile , LO=option . 

or 

SCTD , outf ile , option . 

Parameter Description 



outfile Output file name. This parameter is valid only if a list option is 

specified. The default outfile is file OUTPUT. 

option List option. Enter one or more of the following: 

option Description 



D Formats the data for the DSD L display. This is the default 

list option if the parameters outfile and option are not 
specified. 

L Formats the data for a line printer. 

Figures 9-7 and 9-8 show the SCTD L display. This display shows the various origin types 
along with the service classes valid for each origin type. 

At the bottom of figure 9-8, the display shows how the service classes are prioritized. The 
priority levels are PO through P7. 

When entering the DSD CLASS or PCLASS command, use this utility to see the service 
classes for each origin type or the priority level. Refer to the DSD CLASS or PCLASS 
command in section 5 for further information. 

Valid SCTD L display commands are: 
C omman d Description 



L.+ Pages the display forward. 

L- Pages the display backward. 

L.END Terminates the SCTD utility. 
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L. SCTD 
hh.mm.ss. yy/mm/dd. CDC NETWORK OPERATING SYSTEM 
MID=AA NOS version 

SERVICE CLASS CONTROL TABLE DISPLAY PAGE 1 OF 2 

SYSTEM ORIGIN SERVICE CLASSES 

SY BC RB TS DI NS SS MA CT 10 
II 12 13 



LOCAL BATCH ORIGIN SERVICE CLASSES 
BC 



PRIORITY ORDERED SERVICE CLASSES 

P0 PI P2 . P3 P4 P5 P6 P7 
BC 10 II 12 13 



Figure 9-7. SCTD L Display (Page 1 of 2) 



L . SCTD 
hh.mm.ss. yy/mm/dd. CDC NETWORK OPERATING SYSTEM 
MID=AA NOS version 

SERVICE CLASS CONTROL TABLE DISPLAY PAGE 2 OF 2 

REMOTE BATCH ORIGIN TYPE SERVICE CLASSES 

RB 

INTERACTIVE ORIGIN SERVICE CLASSES 

TS DI 

PRIORITY ORDERED SERVICE CLASSES 

PO PI P2 P3 P4 P5 P6 P7 
BC 10 II 12 13 



Figure 9-8. SCTD L Display (Page 2 of 2) 
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SDSPLAY L Display 

The SDSPLAY utility displays system values used to control job flow. This utility allows 
you to alter the queue priorities and weighting factors associated with the input, output, 
and executing queues for each service class. Also, you can alter the service limits associated 
with each service class. System values that you change using the SDSPLAY utility are valid 
only until the next deadstart. 

To initiate the SDSPLAY utility, enter one of the following commands: 

SDSPLAY, L=outfile,LO=option,I=infile. 

or 

SDSPLAY, outfile, option, infile. 



Parameter 



Description 



outfile 
option 



infile 



Output file name. This parameter is valid only if LO=L or I=infile is 
specified. The default outfile is file OUTPUT. 

List option. Enter one of the following: 

option Description 

D Formats the data for the DSD L display. This is the default 

list option if the parameters outfile and option are not 
specified. 

L Formats the data for a line printer. 

Input file name. If infile is specified, the L display is not activated and 
SDSPLAY reads input directives from file infile rather than from the 
system console via the L display. This option allows you to run an 
SYOT job that changes the system scheduling parameters without 
direct operator intervention. 
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SDSPLAY L Display 



Figures 9-9 through 9-11 show the SDSPLAY-HELP display. This display consists of three 
screens. The first screen (figure 9-9) shows the display commands used to control the utility. 
The other two screens (figures 9-10 and 9-11) show the service class definitions. 



L. SDSPLAY - 


HELP. 




hh.mm.ss. yy/mm/dd. 


CDC NETWORK OPERATING SYSTEM 






MID=AA NOS version 


SDSPLAY COMMANDS 


PAGE 1 OF 3 


COMMAND 




DESCRIPTION 


CLASS=XX 




DISPLAY THE DATA FOR SERVICE CLASS XX. 


END 




END THE PROCESSING OF SDSPLAY. 


GO 




SET ALL ENTERED VALUES INTO THE SYSTEM. 


HELP 




SHOW L DISPLAY COMMANDS FOR SDSPLAY. 


RESET 




IGNORE ALL VALUES ENTERED SINCE THE 
LAST GO. 


+ 




PAGE THE DISPLAY FORWARD. 


- 




PAGE THE DISPLAY BACKWARD. 



Figure 9-9. SDSPLAY-HELP Display (Page 1 of 3) 
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L. SDSPLAY - HELP 

SERVICE CLASS DEFINITIONS PAGE 2 OF 3 

SY SYSTEM SERVICE CLASS. 

BC BATCH SERVICE CLASS. 

RB REMOTE BATCH SERVICE CLASS. 

TS INTERACTIVE SERVICE CLASS. 

DI DETACHED INTERACTIVE SERVICE CLASS. 

NS NETWORK SUPERVISOR SERVICE CLASS. 

SS SUBSYSTEM SERVICE CLASS. 

MA MAINTENANCE SERVICE CLASS. 

CT COMMUNICATION TASK SERVICE CLASS. 



Figure 9-10. SDSPLAY-HELP Display (Page 2 of 3) 



L. SDSPLAY 


- HELP 






SERVICE 


CLASS 


DEFINITIONS 




PAGE 3 of 3 


10 




INSTALLATION 


CLASS 


0. 


11 




INSTALLATION 


CLASS 


1. 


12 




INSTALLATION 


CLASS 


2. 


13 




INSTALLATION 


CLASS 


3. 


THE FOLLOWING 


SERVICE CLASSES 


MAY BE DEFINED AT YOUR SITE. 


14 




INSTALLATION 


CLASS 


4. 


15 




INSTALLATION 


CLASS 


5. 


16 




INSTALLATION 


CLASS 


6. 


17 




INSTALLATION 


CLASS 


7. 


18 




INSTALLATION 


CLASS 


8. 


19 




INSTALLATION 


CLASS 


9. 


II 




INSTALLATION 


CLASS 


I. 


IJ 




INSTALLATION 


CLASS 


J. 


IK 




INSTALLATION 


CLASS 


K. 


IL 




INSTALLATION 


CLASS 


L. 



Figure 9-11. SDSPLAY-HELP Display (Page 3 of 3) 
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Figures 9-12 through 9-14 show the SDSPLAY-CLASS display. This display consists of 
three screens. The first screen shows queue priorities and weighting factors associated with 
the specified service class. The other two screens show service limits associated with the 
specified service class. For additional information concerning queue priorities and service 
limits, refer to the QUEUE and SERVICE commands in section 5, DSD Commands. 



NOTE 



The current number of jobs for the specified service class is displayed at the bottom of the 
second screen. However, this value may not reflect the actual count of jobs running under 
the displayed service class since the displayed value is updated only at the initial processing 
of the SDSPLAY utility or after issuing an L.RESET or L.GO command. 



L. SDSPLAY - CLASS. 
hh.mm.ss. yy/mm/dd. CDC NETWORK OPERATING SYSTEM 
MID=AA NOS version 
ATTRIBUTES FOR SERVICE CLASS SY PAGE 1 OF 3 

DESCRIPTION 

INPUT QUEUE LOWER PRIORITY. 
INPUT QUEUE UPPER PRIORITY. 
OUTPUT QUEUE LOWER PRIORITY. 
OUTPUT QUEUE UPPER PRIORITY. 
EXECUTION QUEUE LOWER PRIORITY. 
EXECUTION QUEUE UPPER PRIORITY. 
EXECUTION QUEUE INITIAL LOWER PRIORITY. 
EXECUTION QUEUE INITIAL PRIORITY. 
INITIAL TERMINAL PRIORITY AFTER I/O. 

INPUT QUEUE WEIGHTING FACTOR. 
EXECUTION QUEUE WEIGHTING FACTOR. 
OUTPUT QUEUE WEIGHTING FACTOR. 

(ALL PRIORITY VALUES ARE 0-7777B) . 
(WEIGHTING FACTORS MUST BE A POWER OF 2 FROM 1 - 4000B) . 



OPTION 


INLP 


= 


7770B 


INUP 


= 


7776B 


OTLP 


= 


7000B 


OTUP 


= 


7776B 


EXLP 


= 


2000B 


EXUP 


= 


7000B 


EXIL 


= 


4000B 


EXIP 


= 


7000B 


EXTP 


= 


4004B 


INWF 


= 


IB 


EXWF 


= 


IB 


OTWF 


= 


IB 



Figure 9-12. SDSPLAY-CLASS Display (Page 1 of 3) 
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SDSPLAY - CLASS. 

ATTRIBUTES FOR SERVICE CLASS SY 



PAGE 2 OF 3 



OPTION 


CT 


— 


100B 


CM 


= 


2 OB 


NJ 


= 


7777B 


CP 


= 


6770B 


FL 


= 


3777B 


AM 


= 


77777B 


EC 


= 


3777B 


EM 


= 


7777B 


PR 


= 


3 OB 


SE 


= 


20B 


RS 


= 


4B 


US 


= 


20B 



DESCRIPTION 



CP TIME SLICE (1-7777B MILLISECONDS*64) 
CM TIME SLICE (0-7777B SECONDS) . 
MAXIMUM NUMBER OF JOBS (0-7777B) . 
CONTROL POINT SLICE PRIORITY (0-7777B). 

MAXIMUM CM FL/100B, ANY JOB (0-3765B). 
MAXIMUM CM FL/100B, ALL JOBS (0-77777B) 
MAXIMUM EM FL/1000B, ANY JOB (0-7777B) . 
MAXIMUM EM LF/1000B, ALL JOBS (0-7777B) 
CPU PRIORITY (2-77B) . 
CPU SLICE EXTENSION (0-7777B MS) . 
CPU RECALL SLICE (1-7777B MS) . 
UNEXTENDED CPU SLICE (1-7777B MS). 



THE CURRENT JOB COUNT FOR THIS SERVICE CLASS IS 



2B. 



Figure 9-13. SDSPLAY-CLASS Display (Page 2 of 3) 



L. SDSPLAY - CLASS. 

ATTRIBUTES FOR SERVICE CLASS SY 



PAGE 3 OF 3 



INDEX 
DS = 
FC = 
CS = 
FS = 

OPTION 

DT = DI 
TD = 341B 



VALUE 
(UNLIMITED) 
(UNLIMITED) 
(UNLIMITED) 
(UNLIMITED) 



DESCRIPTION 



MAXIMUM DIRECT ACCESS FILE 

SIZE (0-7) . 

MAXIMUM NUMBER PERMANENT 

FILES (0-7). 

MAXIMUM PRUS, ALL INDIRECT 

FILES (0-7). 

MAXIMUM PRUS, ONE INDIRECT 

FILE (0-7) . 

DESCRIPTION 



SERVICE CLASS ON DETACH (NOT SS OR DS) 
SUSPENSION TIMEOUT DELAY (0-7777B 
SECONDS*! OB) . 



NOTE - EXTP, DT AND TD ARE USED ONLY FOR INTERACTIVE JOBS. 



Figure 9-14. SDSPLAY-CLASS Display (Page 3 of 3) 



60459300 U 



L-Display Utilities 9-15 



SDSPLAY L Display 



SDSPLAY Commands 

You can enter the following SDSPLAY commands from either the HELP or CLASS displays 
and from any screen. 

Command Description 



L.CLASS=xx Selects the CLASS display and displays the system attributes for the 

service class specified by xx, where xx is any service class defined on the 
HELP display. 

L.END Terminates the SDSPLAY utility. If you made changes to system 

attributes, the changes will not be saved unless you issue a L.GO command 
before issuing the L.END command. 

L.HELP Selects the HELP display and displays the first screen. 

L.GO Saves any changes you made to system attributes using the 

L.keyword=value commands by entering the new values into the system 
tables. The current display remains on the screen. 

L.RESET Clears any changes you made to system attributes using the 

L.keyword=value commands since you issued the last L.GO command. The 
current display remains on the screen. Following a L.RESET command, the 
CLASS displays will display values from the system tables. 

L.+ Pages the HELP or CLASS display forward to the next screen. When the 

last screen is being displayed, the next L.+ command advances the display 
to the first screen. You cannot page from one display (CLASS or HELP) to 
the other display; nor can you page from one service class to another 
service class within the CLASS displays. 

L.- Pages the HELP or CLASS display backward to the previous screen. When 

the first screen is being displayed, this command has no effect on the 
display. 
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Changing System Attributes 

To alter system attributes using the SDSPLAY utility, you select the CLASS display and 
specify the service class using the L.CLASS command. Next, you make changes using 
L.keyword=value commands. The values you enter apply only to the service class being 
displayed. You can enter multiple keyword=value pairs separated by commas in one 
command line. The only limit is the L display input line length restriction. 

When you change system values, the updated values are displayed immediately if the 
corresponding screen is being displayed. If your changes affect a different screen, the 
updated values will be displayed when you page to that screen. Your changes will not be 
entered into the system tables until you enter a L.GO command. You can cancel your 
changes and reset the system values by entering a L.RESET command, but it must be 
entered before you enter the L.GO command. 

You can change system values for a different service class by entering another L.CLASS 
command followed by more L.keyword=value commands. 

L.keyword=value Commands 

You can enter the following L.keyword=value commands from a CLASS display. Although 
you can enter numeric values in either octal or decimal, most of the values are displayed in 
octal. Octal is the input default; you specify decimal values with a radix of D following the 
number. Also, numbers containing an 8 or 9 are interpreted as decimal. 

The keywords are listed in the same order as they appear in the CLASS display. 



Keyword 



Description 



INLP 
INUP 

OTLP 
OTUP 

EXLP 
EXUP 

EXIL 



Priority assigned to a file entering the input queue. The value of INLP 
can range from to 7777 8 , but must be less than the value of INUP. 

Highest priority a file can reach in the input queue; aging stops when 
this priority is reached. The value of INUP can range from to 7777 8 , 
but must be greater than the value of INLP. 

Priority assigned to a file entering the output queue. The value of OTLP 
can range from to 7777 8 , but must be less than the value of OTUP. 

Highest priority a file can reach in the output queue; aging stops when 
this priority is reached. The value of OTUP can range from to 7777 8 , 
but must be greater than the value of OTLP. 

Lowest priority for a job in the execution queue. The value of EXLP can 
range from to 7777 8 , but must be less than the value of EXUP. 

Priority assigned to a job when initially assigned to a control point. 
However, online interactive jobs with terminal I/O available are 
scheduled at EXTP priority. The value of EXUP can range from to 
7777 8 , but must be greater than the value of EXLP. 

Priority a job receives when it initially exhausts its CM or CPU time 
slice. Thereafter, whenever the time slice is exhausted the job's priority 
will be set to the value of EXLP. The value of EXIL can range from to 
7777 8 , but must be in the range of values for EXLP and EXUP. 
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Keyword 



Description 



EXIP 

EXTP 

INWF 

EXWF 

OTWF 

AM 

CM 

CP 
CS 

CT 

DS 

DT 

EC 

EM 

FC 

FL 

FS 

NJ 
PR 
RS 



Initial scheduling priority for an executing job. The value of EXIP can 
range from to 7777 8 , but must be in the range of values for EXLP and 
EXUP. 

Terminal job priority assigned to a terminal job that has terminal input 
or output available. The value of EXTP can range from to 7777 8 , but 
must be in the range of values for EXLP and EXUP. 

Weighting factor for input queue priority calculations. The value of 
INWF must be a power of 2 in the range 1 to 4000 8 . 

Weighting factor for execution queue priority calculations. The value of 
EXWF must be a power of 2 in the range 1 to 4000 8 . 

Weighting factor for output queue priority calculations. The value of 
OTWF must be a power of 2 in the range 1 to 4000 8 . 

Maximum field length divided by 100 8 for all jobs of the specified service 
class. Refer to the SERVICE command in section 3. 

Central memory time slice in seconds. Refer to the SERVICE command 
in section 3. 

Control point slice priority. Refer to the SERVICE command in section 3. 

Cumulative size in PRUs allowed for all indirect access permanent files. 
Refer to the SERVICE command in section 3. 

Control point time slice (seconds). Refer to the SERVICE command in 
section 3. 

Size in PRUs allowed for individual direct access permanent files. Refer 
to the SERVICE command in section 3. 

Service class to which a detached job is assigned. Refer to the SERVICE 
command in section 3. 

Maximum user-accessible extended memory field length in words divided 
by UEBS for any job of the specified service class. Refer to the SERVICE 
command in section 3. 

Maximum extended memory length in words divided by UEBS for all jobs 
of the specified service class. Refer to the SERVICE command in section 
3. 

Number of permanent files allowed. Refer to the SERVICE command in 
section 3. 

Maximum field length divided by 100 8 for any job of the specified service 
class. Refer to the SERVICE command in section 3. 

Size in PRUs allowed for individual indirect access permanent files. 
Refer to the SERVICE command in section 3. 

Maximum number of jobs. Refer to the SERVICE command in section 3. 

CPU priority. Refer to the SERVICE command in section 3. 

Recall CPU slice (milliseconds). Refer to the SERVICE command in 
section 3. 
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Keyword Description 



SE CPU slice extension (milliseconds). Refer to the SERVICE command in 

section 3. 

TD Suspension timeout delay. Refer to the SERVICE command in section 3. 

US Unextended CPU slice (milliseconds). Refer to the SERVICE command in 

section 3. 



SUBSYST L Display 

The SUBSYST L-display utility displays information about all the subsystems supported by 
NOS. To begin the SUBSYST utility enter one of the following commands: 

SUBSYST, L=outf ile,LO=option. 
or 

SUBSYST, outfile, option. 

Parameter Description 

outfile Output file name. This parameter is valid only if a list option is 

specified. The default outfile is file OUTPUT. 

option List option. Enter one of the following: 

option Description 

D Formats the data for the DSD L display. This is the default 

list option if the parameters outfile and option are not 

specified. 

L Formats the data for a line printer. 



If you do not specify outfile and option, the data is written to the L display. 

Refer to the NOS Version 2 Operations Handbook for further information regarding the 
SUBSYST L display. 
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This section contains information about LID configuration files, RHF configuration files, and 
QTF configuration requirements. 

LID Configuration File 

You create a LID configuration file to define the physical and logical machines available for 
your system. After a level deadstart, the system program CLDT searches for the LID 
configuration file on user index 377777 8 . It will use the information in this file to generate a 
logical identifier table (LDT) in central memory. 

This section describes how to create and maintain the LID configuration file (LIDCMid). 
Specifically, how to: 

Create the LIDCMid file using NPID and NLID configuration statements. 

Specify the size of the LID table using the CMRDECKLDT entry. 

Build or rebuild the LID table using the X.CLDT command. 

List the current LID table using the LISTLID command. 

Change LIDs and LID attributes using the LIDOU display. 

Specify the requirements for running NOS/VE in dual-state mode. 

Creating the LIDCMid File 

The first line of the LIDCMid file should be a 1- to 7-character name for the LID 
configuration file. Use this format for naming the file: 

LIDCMid 

Value Description 

id 2-character machine identifier for the mainframe. 

You can place comment lines in the file by putting an asterisk in column 1 or by putting the 
word COMMENT beginning in column one. 

Example: 

LIDCM64 

*LIDCMID FILE FOR MAINFRAME 64. 

You should define each PID (physical identifier) and all the LIDs (logical identifiers) 
associated with the PID by using NPID and NLID statements. 
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NPID Statement 

Use one NPID statement to define each physical mainframe available to your system. Use 
this format for the NPID statement: 

NPID , PID=pid , ENABLED=status , MFTYPE=type , AT=at , NETDIS=sub . 



Parameter 



Description 



PID=pid 



Physical identifier; pid is the 3-character physical identifier for the 
mainframe. For NOS, pid should be Mid, where id is the 2-character 
machine identifier defined by the MID=id CMRDECK entry. 
Required. 

ENABLED=status Specifies whether the mainframe identified by PID is available. You 
can enter YES or NO. Default is YES. 



MFTYPE=type 



AT=at 



NETDIS=sub 



Mainframe type; type is any 1- to 7-character string specifying the 
mainframe type or mainframe identifier (for example, NOSBE, NOS, 
CY200, NOSMF2, CLSH1). Required. 

Specifies the attribute associated with the mainframe identified by 
PID. You can specify multiple attributes by using a slant separator 
(AT=VALID/NLIST) or by repeating the parameter 
(AT=VALID,AT=NLIST). 



at 



Description 



VALID Specifies that USER command prevalidation is 

required. This parameter causes the local host to verify 
that a user is authorized. This prevalidation is 
performed in addition to the normal user validation 
performed at the remote host. 

NVALID Specifies that USER command prevalidation is not 
required. 

NLIST Specifies that this PID is not available to the end user 

through the LISTLID command. 

The default attributes are: USER command prevalidation is not 
required and PID is listable using the LISTLID command. 

Specifies which network accesses to the mainframe identified by PID 
are disabled. By default, all network accesses are enabled. You 
should not specify NETDIS for the host PID. Any combination of 
network accesses may be used (for example, NETDIS=RHF/SSF). 



sub 



Description 



NAM Network Access Method. 

RHF Remote Host Facility. 

SSF SCOPE Station Facility. 
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NLID Statement 

Use NLID statements after each NPID statement to define the relationship between each 
PID and its associated LIDs and the attributes of the LIDs. Use this format for the NLID 
statement: 

NLID , LID=1 id , ENABLED=s tatus , AT=at . 



Parameter 



Description 



LID=lid 



ENABLED=status 



AT=at 



Logical identifier; lid is the 3-character logical identifier for the 
mainframe identified by the last NPID statement. One fid entry 
must be the same as the last pid. Required. 

Specifies whether the mainframe identified by LID is available. You 
can enter YES or NO. Default is YES. 

Specifies the attribute associated with the mainframe identified by 
LID. You can specify multiple attributes by using a slant separator 
(AT=STOREF/VALID) or by repeating the parameter 
(AT=STOREFAT=VALID). 



at 



Description 



LOOPB Loopback capability for RHF testing. This testing can 

be performed on one mainframe with one NAD. The 
attribute of LOOPB is valid only for LIDs defined for 
the host (local) mainframe. 



You should not specify the LOOPB attribute if the 
STOREF attribute is specified. 

STOREF Store and forward capability indicating that the 

specified mainframe will act as part of the network in 
store and forward mode. Data will pass through the 
machine and into the network. 



You should not specify the STOREF attribute if the 
LOOPB attribute is specified. 

VALID Specifies that USER command prevalidation is 

required and can be specified only if the STOREF 
attribute is specified. This parameter causes the 
mainframe defined as being in store and forward mode 
(AT=STOREF) to verify that a user is authorized. This 
prevalidation is performed in addition to the normal 
user validation performed at the remote host that 
processes the job. 

NVALID Specifies that USER command prevalidation is not 
required and can be specified only if the STOREF 
attribute is specified. 

NLIST Specifies that this LID is not available to the end user 

through the LISTLID command. LIDs with this 
attribute might be reserved for onsite maintenance 
purposes. 
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Equipment Configuration Example 



Figure 10-1 shows an equipment configuration consisting of six mainframes. Figure 10-2 
shows the LIDCMid files for the three NOS mainframes in the configuration: LIDCM64, 
LIDCM42, and LIDCM05. 
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Figure 10-1. Equipment Configuration 
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LIDCM64 

*LIDCM64 LIDCMID FILE FOR MAINFRAME 64. NOTE THAT LID=LBK IS 

* DEFINED AS A LOOPBACK LID AND THAT THE NAM NETWORK IS 

* DISABLED TO NOS PID=M42 . 
NPID,PID=M64, MFTY PE=NOSHOST , AT=VALID . 
NLID,LID=M64. 

NLID,LID=AAA. 

NLID,LID=AAB. 

NLID , LID=LBK, AT=LOOPB . 

NPID, PID=M42, MFTYPE=NOS42 , NETDIS=NAM. 

NLID,LID=M42. 

NLID,LID=BBB. 

NLID,LID=BBC. 

NLID, LID=NBE, AT=STOREF/NLIST . 

NLID , LID=CCC , AT=STOREF . 

NPID, PID=MF2 , MFTYPE=SCOPE2 , AT=NVALID . 

NLID,LID=MF2. 

NLID,LID=SC2. 

NPID,PID=120,MFTYPE=C120,AT=NVALID. 

NLID,LID=120. 

NPID , PID=M05 , MFTYPE=NOS05 . 

NLID,LID=M05. 

NLID,LID=DDD. 

NLID , LID=NBE, AT=STOREF . 

NLID , LID=CCC , AT=STOREF . 



LIDCM42 

*LIDCM42 LIDCMID FILE FOR MAINFRAME 42. NOTE THAT LID=NBE IS 

* DEFINED AS A STORE AND FORWARD LID FOR THE NOS/BE MAINFRAME. 

NPID , PID=M42 , MFTYPE=NOSHOST . 

NLID,LID=M42. 

NLID,LID=BBB. 

NLID,LID=BBC. 

NLID , LID=M64 , AT=STOREF . 

NLID, LID=CCC, AT=STOREF . 

NLID,LID=NBE,AT=STOREF. 

NLID , LID=LBK, AT=LOOPB . 

NPID, PID=M64 , MFTYPE=NOS64 , NETDIS=NAM. 

NLID,LID=M64. 

NLID,LID=AAA. 

NLID,LID=AAB. 

NPID, PID=NBE. MFTYPE=NOSBE, AT=NVALID. 

NLID,LID=NBE. 

NLID,LID=CCC. 

NPID , PID=12 , MFTYPE=C12 , AT=NVALID . 

NLID,LID=120. 



LIDCM05 

♦LIDCM05 LIDCMID FILE FOR MAINFRAME 05. AGAIN, NOTE THAT 

* LID=NBE IS DEFINED AS A STORE AND FORWARD LID FOR THE 

* NOS/BE MAINFRAME. 
NPID, PID=M05, MFTYPE=M05 . 
NLID,LID=M05. 

NLID , LID=LBK, AT=LOOPB . 

NLID , LID=M64 , AT=STOREF . 

NLID , LID=CCC , AT=STOREF . 

NLID , LID=NBE , AT=STOREF . 

NPID, PID=NBE,MFTYPE=NOSBE, AT=NVALID. 

NLID,LID=CCC. 

NLID,LID=NBE. 

NPID, PID=M64 , MFTYPE=NOS64 . 

NLID,LID=M64. 



Figure 10-2. LIDCMid Files for Example Equipment Configuration 
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Specifying the Size of the LED Table 

You should specify the size of the LID table (LDT) in central memory with this CMRDECK 
entry: 

LDT=nnnn . 

Value Description 

nnnn Number of central memory words allocated to the LDT (default=l, 

minimum =0, maximum=1100 8 ). 

You can calculate the value for nnnn by using this formula: 

(3+lid)*pid 

Value Description 

lid Maximum number of LIDs allowed per PID. 

pid Total number of PIDs in all networks. 



Building or Rebuilding the LED Table 

When you deadstart the system, the system program CDLT automatically looks for the 
LIDCMid file under user index 377777 8 . It will use the file to automatically create the LID 
table in central memory. 

If the system cannot find the file, or if there are errors in the file, an error message will be 
displayed in the dayfile. You can then create or correct your LIDCMid file and execute the 
X.CLDT command to build or rebuild the LID table in central memory. 

To build or rebuild the LID table in central memory, follow these steps: 

1. Create or correct your LIDCMid file and ensure that the file is stored as an indirect 
access file on user index 377777 8 . 

2. Ensure that all subsystems that access the LID table (NAM, RHF, and SSF) are not 
active. 

3. Enter this command: 

X.CLDT 

The system will build or rebuild the LID table in central memory. 
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Listing the LID Table 

You can use the LISTLID command to list the configuration of the LID table. The LISTLID 
command can be executed through an interactive or batch environment. Use this format for 
the command: 

LISTLID 

LISTLID, LID=lid, PID=pid, L=list . 

Parameter Description 

LID=lid List the attributes of PIDs in which LID lid exists. LID lid must be 

enabled and it must be a listable LID. If the LID keyword is 
specified, a LID value lid must also be specified. If the LID keyword 
is omitted, the default is to list all listable LIDs. 

PID or PID=pid List the attributes of a given LID (LID=lid specified) or all LIDs (LID 
omitted) under a given PID (PID=pid specified) or all PIDs (PID 
specified). If the PID keyword is omitted, the default is to list all 
listable LIDs specified by the LID parameter. 

L=list Specifies the local file to which all listable output is to be written. If 

the L keyword is omitted, the default is file OUTPUT. 



Changing LIDS Using the LTOOU Display 

You can change LIDs by using the LlDOU display. Refer to section 9, L-Display Utilities, 
for information about the LIDOU display. 

Specifying Requirements for Running NOS/VE in Dual-State Mode 

You must create the appropriate configuration files before users can route batch jobs from 
the NOS side of a dual-state system to the NOS/VE side. 

You must define the LIDs for NOS/VE batch jobs in the LIDCMd file. You can define a 
maximum of 30 NOS/VE LIDs. 

Create the indirect access file LIDVEid (id is a 2-character machine identifier for the 
mainframe) on user index 377777 8 . The LIDVEid file is used by the dual-state IRHF job. 
This file contains the LIDs to be used for NOS/VE batch jobs, in the following format: 

nvelid 1 
nvelid 2 

nvelid 30 

Each LID must be on a separate line. 

In the LIDCMid file used by CLDT, you should use an NPID statement to define a PID for 
the NOS/VE side of your dual-state system and include NLID statements for each of the 
LIDs in the LIDVEid file. The PDD value used is not significant but must be unique. In a 
QTF network environment, you should also define the NOS/VE LIDs as store and forward 
(AT=STOREF) under the NOS host PID to allow storing and forwarding of batch jobs from 
other hosts through the NOS side of a dual-state system to the NOS/VE side. 
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RHF Configuration Files 

You must define the RHF configurations including all NADs, applications, and physical 
identifiers (PIDs) to be used by or accessible to RHF. You may define multiple 
configurations. Each RHF in the network must have its own definition of the configuration; 
each definition will be different from the definition of the configuration for other RHFs in 
the network. Use the RCFGEN utility to define these configurations. 

RCFGEN Utility 

The RCFGEN utility reads network configuration statements to create the RHF 
configuration record, which RHF uses to define the network and determine proper access. 

Each configuration record has a name of one to seven letters or digits, starting with a letter. 
The default name set by RCFGEN when creating a record (and used by RHF when 
searching for a record) is RCFpid, where pid is the three-character physical identifier of the 
host. You can use the RN=recname parameter on the RCFGEN and RHF commands to 
specify a different configuration record name. 

When RHF is initiated, it searches for the specified configuration record first on local file 
RCFILE, then on permanent file RCFpid (user name SYSTEMX, direct or indirect access), 
and finally on the system library. 

By default, RHF searches for configuration record name RCFpid. If you provide a 
subsystem procedure file for RHF, you can use the command RHF,RN=recname to specify a 
different name. Refer to the NOS Version 2 Installation Handbook for information about 
creating a procedure file for RHF. 
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The following command calls the RCFGEN utility. 

RCFGEN , I=input , L=list , O=output , RN=recname , LO=option . comments 
The parameters are order independent and optional; if omitted, the defaults are used. 



Parameter 



Description 



I=input 

L=list 

0=output 

RN=recname 

LO=option 



comments 



Specifies the local file from which the network configuration 
statements are to be read. The default is file INPUT. If only the 
keyword I is specified, file COMPILE is used. 

Specifies the local file to which all hstable output is to be written. 
The default is file OUTPUT. 

Specifies the local file to which the configuration tables are to be 
written. The default is file RCFILE. 

Specifies the name given to the configuration record being 
generated. The default name, RCFpid, is used if RN is omitted, if 
only the keyword RN is specified, or if recname is 0. 

Specifies the list options used when generating hstable output. If 
LO is omitted or option is 0, only the network configuration 
statements and diagnostics are listed. If only the keyword LO is 
specified, macro definitions and table-generating definitions are also 
listed. LO=ALL specifies all list options. (The non-default list 
options may help analysis of RCFGEN or RHF problems.) 

Specifies an optional 1- to 70-character string that is placed in the 
prefix table of the configuration record being generated. (During 
initiation, RHF displays the string in the job dayfile.) 
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RCFGEN Input 

The input to RCFGEN consists of network configuration statements. The syntax of these 
statements conforms to COMPASS statements. Configuration statements (except LNAD 
and RNAD statements) must not start before character position 3. 

Use the following network configuration statements. 
Statement Description 



LNDR Defines the maximum number of local NAD drivers (NDRs) allowed 

to execute at one time. 

APPL Defines application programs that are allowed to access RHF. 

NPID Defines the physical identifier of a remote mainframe. 

PATH Defines the paths to a remote mainframe through the LCN network. 

LNAD Defines information necessary to address local NADs. 

RNAD Defines the addressing information necessary to access a remote 

NAD. 

DEBUG Defines debug parameters. 

CHARGE Defines the charge that is transferred to a user control point for 

each RHF call. 



Statement Order 

Network configuration statements must be specified in the following order to properly define 
a network. 

1. LNDR statement (if necessary). 

2. APPL statement to define application programs. 

3. Sets of NPID and PATH statements that define all portions of the network. The PATH 
statement must be associated with a given physical ma infr ame (NPID statement). The 
following structure is required of these statements when defining a network: 

a. NPID statement. 

b. All paths (PATH statement) associated with the preceding NPDD. 

4. LNAD statements to define local NADs. 

5. RNAD statements to define hardware addressing of remote NADs. 

6. DEBUG and CHARGE statements (order independent). 

At least one of each configuration statement is required in the configuration file with the 
exceptions of the LNDR, DEBUG, and CHARGE statements. Defaults are specified in the 
individual statement descriptions. 
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Network Configuration Statements 

The network configuration statements are described in the order that they must be specified 
to define a network. 



LNDR Statement 

The maximum number of NAD drivers is the maximum number of PPs that may contain a 
NAD driver at one time, regardless of the number of NADs and the number of drivers 
allowed per NAD. 

To define the maximum NDRs allowed for all NADs, enter: 

LNDR MAXNDRS=nn 



Parameter 



MAXNDRS=nn 



Description 



Maximum number of PPs that may contain NDRs at any one time. 
Default is 4. The maximum value is the number of PPs available 
for NAD drivers, nn must not be less than the largest value 
specified for MAXNDRS on any LNAD statement. 



APPL Statement 

Each application definition uses additional RHF field length. This additional field length is 
equal to mxcopys*(5+3*mxcons) central memory words (mxcopys and mxcons are defined 
below). To define an RHF application, enter: 

APPL NAME=name , ENABLED=status , MXCOHS=mxcons , MXCOPYS =mxcopys , SVR=status , 
ASTART=status , SYSORG=status 



Parameter 

NAME=name 



ENABLED=status 



MXCONS=mxcons 



MXCOPYS=mxcopys 



Description 



Application name; name is 1- to 7-alphanumeric characters, 
where the first character must be alphabetic. Required. 

Availability of the application when RHF is initiated, status 
may be YES or NO. Default is YES. 

Maximum simultaneous connections that are allowed for this 
application. The maximum value for mxcons is 127. Default is 
1. 

Maximum number of simultaneously active copies of this 
application that are allowed. The maximum value for mxcopys 
is 127. Default is 1. 
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Parameter 



Description 



SVR=status 



ASTART=status 



SYSORG=status 



Servicer program status; specifies if the application is a 
servicer, that is, an application program that is started 
automatically by EHF upon request of an application program 
on another host, status may be YES or NO. Default is NO. 

Application startup status; specifies whether the application is 
started when RHF is initiated or when the operator enables the 
application, status may be YES or NO. If NO is specified, the 
application is started by the user, or for a servicer application, 
by a request from a remote application. Default is NO. 

System origin status; specifies whether the application must 
have privileged application status to gain access to RHF. status 
may be YES or NO. If status is YES, the application must have 
an SSJ= entry point and be loaded from the system library. If 
status is NO, the application need not reside on a system 
library; however, the user must have CUCP (system control 
point) validation. Default is YES. 



In determining the number of allowed connections and copies of an application, note that 
each NAD has a maximum of 127 active connections. This number is restricted to 35 during 
NAD controlware loading but may be increased by modifying the appropriate NAD 
controlware load parameters in LOADBC. 

When defining the APPL statements you must follow certain restrictions for 
system-supplied applications QTF, QTFS, PTF, PTFS, and ITF. The maximum 
simultaneous connections should be set to one (defeult) for QTFS, PTF, and PTFS. The 
maximum number of simultaneously active copies should be set to one (default) for QTF and 
ITF. The maximum simultaneous connections for QTF should be set to four unless 
installation parameters ACNMAXC for QTF and MAXFILEXFR for FIP are changed. The 
SVR=YES parameter must be specified for QTFS and PTFS and must not be specified for 
QTF, PTF, or ITF. ASTART=YES should be specified for QTF. 

For ITF, the maximum simultaneous connections should be equal to the value of the PI 
parameter on the ITF command in the JOBITF record on the NAMI startup master file. 
The released default is 2. 

The MHF application is defined by default in RHFs configuration file; no separate definition 
is needed. If you choose to define MHF, you must specify ASTART=YES to allow initial 
loading of controlware into local NADs. 
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NPID Statement 

Each remote mainframe definition requires three words in RHFs field length. To define a 
remote mainframe, enter: 

NPID PID=pid , ENABLED=status , MFTYPE=type 



Parameter 



Description 



PID=pid 



ENABLED=status 



MFTYPE=type 



Physical identifier of the remote mainframe; pid must be a 
unique 3-eharacter physical identifier. Required. 

Availability of the mainframe identified by PID. status may be 
YES or NO. Default is YES. 

Mainframe type; type is any 1- to 7-character string specifying 
the mainframe type or mainframe identifier. For example, you 
could use NOS1, NOS2, NOS/BE, or CY200. Required. 



PATH Statement 

Every path defined for a remote mainframe requires two words in RHFs field length. To 
define a path for a remote mainframe, enter: 

PATH ENABLED=status , LT=tttt , RT=rrrr , RNAD=raddr , LNAD=laddr , AC=aaaa 



Parameter 



Description 



ENABLED=status 
LT=tttt 

RT=rnT 

RNAD=raddr 
LNAD=laddr 
AC=aaaa 



Availability of the path when RHF is initialized, status may be 
YES or NO. Default is YES. 

Local trunk control units (TCUs) enabled; tttt is a 4-digit 
nonzero binary number indicating the network trunk 
connections for the local NAD. Required. 

Remote TCUs enabled; rrrr is a 4-digit nonzero binary number 
indicating the network trunk connections for the remote NAD. 
Required. 

Symbolic address of the remote NAD entry for this path 
referenced in the RNAD statement. Required. 

Symbolic address of the local NAD entry for this path 
referenced in the LNAD statement. Required. 

Access code; aaaa is a 4-digit hexadecimal access code for the 
remote NAD. Default is 0. 



At least one PATH statement is required for each PID defined. 
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LNAD Statement 

Each local NAD definition requires five words in RHFs field length. To define a local NAD, 
enter: 

laddr LNAD CH=ch,MAXNDRS=n,DEDICATE=status r CMPATHS=nn, CMBUFFS=nn, 
AUTODUMP=StatUS , AUTOLOAD=status , TRACE=trw, LOG=status 



Parameter 



Description 



laddr 



CH=ch 



MAXNDRS=n 



DEDICATE=status 



CMPATHS=nn 



CMBUFFS=nn 



AUTODUMP=status 



AUTOLOAD=status 



Symbolic address referenced in a preceding PATH statement. 
This parameter is required and must begin in character 
position 1 or 2. 

Channel number; ch is a 2-digit octal number of the channel to 
which the NAD is connected. 

Maximum number of NAD drivers that may be assigned at one 
time to this NAD. n can be from 1 to 3. Default is 1. 

Dedicated channel status; specifies whether the driver will 
always hold the NAD channel reservation between consecutive 
blocks of one I/O request, status may be YES or NO. Default is 
YES. YES should be specified unless some non-CDC driver 
requires high-performance access to the NAD channel. 

Maximum number of convert mode paths. You can specify a 
number from to 63. The default is 0. If nn is 0, then code 
conversion is done in the CPU. Refer to table 10-1 for 
additional information. 

Maximum number of convert mode buffers. You can specify a 
number from to 63. The default is 0. Refer to table 10-1 for 
additional information. 

Automatic dump status; specifies whether RHF will 
automatically dump the NAD's memory if the NAD fails, status 
may be YES or NO. Default is NO. (YES is intended for fault 
analysis along with TRACE=YES/FULL). 

Automatic load status; specifies whether RHF will 
automatically load the NAD's controlware during initialization 
and reload the NAD if it fails, status may be YES or NO. 
Default is YES. 
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Parameter 



Description 



TRACE=trw 



LOG=status 



NAD trace word; controls the value of trace word in the NAD 
microcode initialization parameters used by MHF when loading 
the NAD (refer to the 380-170 Network Access Device 
Reference Manual for a complete description), trw may be NO 
(no trace), YES (standard trace buffers), or FULL (maximum 
trace buffers). Default is NO. 

Because TRACE decreases NAD performance, TRACE should 
be specified only for fault analysis. AUTODUMP=YES should 
be specified along with TRACE=YES or FULL to capture the 
NAD memory dump. TRACE=YES or FULL produces a trace 
word value of 2954 or 529F hexadecimal, respectively. 

Error logging status; specifies if local NAD trunk errors are to 
be transmitted by MHF to the mainframe's binary maintenance 
log. status may be YES or NO. Default is YES. 



The software relies on the NAD to determine the actual number of paths and buffers 
reserved for code conversion. The algorithm used by the NAD is: 

Paths reserved = the smaller of (paths requested) or (buffers reserved * 2/3). 
Buffers reserved = the smaller of (buffers requested) or (total buffers — 2). 

The code conversion parameters should be adjusted according to the average number of 
concurrently active connections doing code conversion and the average size of the files being 
converted. Table 10-1 gives some suggested values for the code conversion parameters. In 
this table, the term average connection implies four conversion connections. The term 
average file size is a file approximately 500 PRUs long. 

Table 10-1. Suggested Code Conversion Parameters 



Connections 



96K-Byte 
NAD 



128K-Byte NAD 



Less than average connections, average file size 
Less than average connections, large file sizes 
Average connections, average file sizes 
Greater than average connections, average file sizes 
Greater than average connections, large file sizes 



2 paths 

3 buffers 


2 paths 

3 buffers 


2 paths 
5 buffers 


2 paths 
5 buffers 


4 paths 

5 buffers 


6 paths 
8 buffers 


6 paths 
9 buffers 


7 paths 
11 buffers 


5 paths 
9 buffers 


6 paths 
13 buffers 
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RNAD Statement 

Every remote NAD defined requires four words in RHF's field length. To define a remote 
NAD, enter: 



raddr 



Parameter 



RNAD ND=nn,DD=d,LOG=status 



raddr 

ND=nn 

DD=d 

LOG=status 



Description 



Symbolic address referenced in a preceding PATH statement. 
This parameter is required and must begin in character 
position 1 or 2. 

Remote NAD address; nn is a 2-digit hexadecimal address of 
the remote NAD. Default is 0. 

Remote NAD exit port; d is a 1-digit hexadecimal address of the 
exit port of the remote NAD. Default is 0. 

Error logging status; specifies if remote NAD trunk errors are 
to be recorded by MHF in the mainframe's binary maintenance 
log. status may be YES or NO. Default is NO. Do not specify 
LOG=YES if the defined NAD is a local NAD (as in the case of 
a loopback path). Instead, use the LOG parameter on the 
LNAD statement to control error logging. 



DEBUG Statement 

The DEBUG statement controls the manner in which RHF uses queue entries. 

DEBUG TRACE= status 



Parameter 



TRACE=status 



Description 



RHF trace status; specifies whether the RHF trace is on or off. 
status may be YES or NO. Default is NO. NO specifies that 
RHF trace is off and queue entries freed by RHF are placed at 
the top of the empty queue and reused immediately. RHF uses 
a slightly smaller amount of processing time when the RHF 
trace is off. Default is NO. 

YES specifies that RHF trace is on and a queue entry is reused 
only after all queue entries ahead of it have been used. Also, 
when the RHF trace is on, you can use it for analysis of an 
RHF dump and resolution of the associated RHF problem. 
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CHARGE Statement 

The CHARGE statement specifies the amount of system resources a user control point is 
charged for an RHF call. RHF distinguishes two different types of calls; those that require a 
large amount of processing time and those that require a small amount of processing time. 

CHARGE TYPE=type, CPA=cpa, CPB=cpb, IO=io, CMFL=cm, PP=pp 



Parameter 



Description 



TYPE=type 



Type of call for which the charge is being specified. 



Type 



Description 



1 
2 



Requires small amount of RHF processing time. 
Requires large amount of RHF processing time. 



CPA=cpa 

CPB=cpb 

IO=io 
CMFL=cm 

PP=pp 



Time to be charged for central processor cpa (decimal milliseconds). 
Default is 2 milliseconds for a type 1 call; 10 milliseconds for a type 
2 call. 

Time to be charged for central processor cpb (decimal milliseconds). 
Default is 0. 

Input/output time to be charged (decimal milliseconds). Default is 0. 

Central memory field length to be charged, cm is the field length in 
octal divided by 100 8 . Default is 10 8 . 

PP time to be charged (decimal milliseconds). Default is 0. 



A CHARGE statement is not required. You may, however, enter two CHARGE statements: 
one for type 1 calls, a second for type 2 calls. 
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LCN Examples 



Figure 10-3 illustrates a sample LCN network and is the basis of the network configuration 
statements shown in figures 10-4 and 10-5. Figure 10-4 shows the network configuration 
statements for the RHF on mainframe MFA. Figure 10-5 shows the network configuration 
statements for the RHF on mainframe MFD. 
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Figure 10-3. Sample LCN Network 
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LNDR 


MAXNDRS=3 




APPL 


NAME=QTF , MXCONS=4 , ASTART=YES 




APPL 


NAME=QTFS , MXCONS=l , MXCOPYS=8 , ASTART=NO , SVR=YES 




APPL 


NAME=PTF , MXCONS=l , MXCOPYS=8 , ASTART=NO 




APPL 


NAME=PTFS , MXCOPYS=8 , SVR=YES 




APPL 


NAME=USRAP , MXCONS=6 , ENABLED=NO 




APPL 


NAME=ITF , MXCONS=2 , MXCOPYS=l , ASTART=NO , SVR=NO 




NPID 


PID=MFB , ENABLED=YES , MFTYPE=NOS2 




PATH 


ENABLED=YES , LT=0110 , RT=0110 , RNAD=RN2 , LNAD=LN1 , AC=F0F0 




PATH 


ENABLED=YES , LT=0001 , RT=1000 , RNAD=RN1 , LNAD=LN2 , AC=FOF0 




PATH 


ENABLED=NO , LT=0001 , RT=0100 , RNAD=RN2 , LNAD=LN3 , AC=F0F0 




PATH 


ENABLED=YES , LT=0100 , RT=1000 , RNAD=RN1 , LNAD=LN3 , AC=F0F0 




NPID 


PID=MFC , MFTYPE=NOS2 




PATH 


ENABLED=NO , LT= 1 1 , RT= 0110, RNAD=RN3 , LNAD=LN1 , AC=F OF 




PATH 


ENABLED=NO , LT=0001 , RT=1000 , RNAD=RN3 , LNAD=LN2 , AC=F0F0 




PATH 


LT=0101 , RT=1010 , RNAD=RN3 , LNAD=LN3 , AC=F0F0 




PATH 


LT=1000 , RT=0 001 , RNAD=RN3 , LNAD=LN4 , AC=F0F0 




NPID 


PID=MFD , MFTYPE=NOS2 




PATH 


LT=0010 , RT=0010 , RNAD=RN4 , LNAD=LN1 , AC=F0F0 




PATH 


LT=0001 , RT=0010 , RNAD=RN4 , LNAD=LN3 , AC=F0F0 


LN1 


LNAD 


CH=6 


LN2 


LNAD 


CH=7 


LN3 


LNAD 


CH=20 


LN4 


LNAD 


CH=11 


RN1 


RNAD 


DD=0 , ND=4A, LOG=YES 


RN2 


RNAD 


DD=0 , ND=3F , LOG=YES 


RN3 


RNAD 


DD=0 , ND=62 , LOG=YES 


RN4 


RNAD 


DD=0 , ND=11 , LOG=YES 



Figure 10-4. Network Configuration Statements for the RHF on Mainframe MFA 
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APPL 




APPL 
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APPL 




NPID 




PATH 




PATH 




NPID 




PATH 




NPID 




PATH 


LN1 


LNAD 


RN01 


RNAD 
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RNAD 
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RNAD 


RN62 


RNAD 



NAME=QTF , ASTART=YES , MXC0NS=4 

NAME=QTFS,MXCOPYS=4 , SVR=YES 

NAME=PTF , MXCOPYS=6 

NAME=PTFS , MXCOPYS=6 , SVR=YES 

NAME=ITF , MXC0NS=2 , MXCOPYS=l , ASTART=NO , SVR=NO 

PID=MFA, MFTYPE=NOS2 

RNAD=RN01, LNAD=LN1 , LT=0010 , RT=0010 , AC=F0F0 

RNAD=RN03 , LNAD=LN1 , LT=0010 , RT=0001 , AC=F0F0 

PID=MFB , MFTYPE=NOS2 

RNAD=RN3F, LNAD=LN1 , LT=0010 , RT=0100 , AC=F0F0 

PID=MFC , MFTYPE=NOS2 

RNAD=KN62 , LNAD=LN1 , LT=0010 , RT=0010 , AC=F0F0 

CH=4 

ND=01,LOG=NO 
ND=03 , LOG=NO 
ND=3F,LOG=NO 
ND=62,LOG=NO 



Figure 10-5. Network Configuration Statements for the RHF on Mainframe MFD 

QTF Configuration Requirements 

You must create the appropriate configuration files before you can perform queued file 
transfers using RHF or NAM. 

RHF Configuration File Directives 

For each copy of QTF that you want RHF to start automatically on a NOS host, you must 
include the following network configuration statement in the RCFGEN input file for that 
host: 

APPL NAME=QTF , MXCONS=4 , ASTART=YES 

Refer to the APPL statement under RHF Configuration Files earlier in this section. 

Each copy of QTF will establish at most four simultaneous connections. For most RHF 
configurations, a single copy of QTF should be sufficient. 

To allow a NOS host to receive queued files, you must include the following network 
configuration statement in the RCFGEN input file for that host: 

APPL NAME=QTFS , SVR=YES . MXCOPYS=n 

where n is the maximum number of QTFS servers you want to have active. Each copy of 
QTFS services one connection. 

Refer to the appropriate reference manuals for other RHF implementations for information 
on how to configure non-NOS QTF and QTFS applications and connections. 



10-20 NOS Version 2 Analysis Handbook 60459300 U 



QTF Configuration Requirements 



NAM Configuration File Directives 

In the NDLP input file, you must include QTFS OUTCALL statements for each PID to 
which you want to transfer queued files and one APPL statement for QTF: 

QTF : APPL , PRI V , PRU , NETXFR , MXCOPY=n . 

where n is the maximum number of QTF initiators you want to have active. 

Parameter records in the NAMI job record file NAMSTRT specify which applications NAM 
automatically starts. Each default parameter record produced when QTF is installed 
includes one JOB(JOBQTF,QT) directive. To automatically start more than one copy of 
QTF, you can add additional job records to the NAMSTRT file and must add additional JOB 
directives to each parameter record desired. Refer to the NAM5 - Network Access Methods 
Version 1 subsection of the Special Product Installation Information section of the NOS 
Version 2 Installation Handbook for more information on NAMI job records. 

Each copy of QTF will establish at most four simultaneous connections for file transfers. 
For many NAM configurations, a single copy of QTF should be sufficient. You might 
consider using more than one copy of QTF if you expect a large number of queued file 
transfers over slow communication lines. 

To allow a NOS host to receive queued files, you must include in the NDLP input file for 
that host one or more QTFS INCALL statements and one APPL statement for QTFS: 

QTFS : APPL , RS , PRI V , PRU , NETXFR , MXCOPY=n . 

where n is the maximum number of QTFS servers you want to have active. Each copy of 
QTFS services one connection. Refer to the Network Access Method Network Definition 
Language Reference Manual for more information on APPL, INCALL, and OUTCALL 
statements. 

The default NAMI parameter records include a JOB(JOBQTFS,QS) directive. The 
JOBQTFS job record creates or modifies permanent file ZZQTFS, which contains the job file 
submitted by NAM to start a new copy of QTFS when necessary. 
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QTF Procedure File 

The QTF procedure file contains a set of default initialization commands for each of the two 
QTF variants, RHF and NAM. You can edit the commands in the procedure and capture the 
modified procedure in a new system file without rebuilding QTF, or you can include 
UPDATE modifications in the USER file for the RHP installation procedure. The QTF 
procedure is deck QTFPROC on the RHPlpsrin program library file (refer to the NOS 
Version 2 Installation Handbook). 

For the NAM variant, another option is to modify the JOBQTF record (on file NAMSTRT), 
which is used to start QTF at NAM initiation. 

Format of the call to the QTF procedure file is: 

QTF, variant , I=inf ile . 

Parameter Description 

variant RHF or NAM, identifies which QTF variant to initiate. The default 

is RHF. 

infile File name from which initialization commands are to be processed. 

Default is to use the commands for the variant included in the QTF 
procedure file. QTF reads the initialization commands until 
end-of-record. Each command on the file is a separate line 
(equivalent to a K-display entry without the K. prefix). Specifying 
I=infile is equivalent to entering the command 
KINCLUDE,FILE=infile. 



10-22 NOS Version 2 Analysis Handbook 60459300 U 



QTF Configuration Requirements 



Procedure File Example 

Figure 10-6 shows some typical sets of initialization commands that you can include in the 
QTF procedure file. The example assumes you started with the default QTF procedure file. 



.PROC,QTF*I, ... 

.DATA,XXDEFI 

. IF, $NAM$ . EQ . $NO$ , LI . 

* 

.* DEFAULT DIRECTIVES FOR NOS RHF VARIANT 
* 

SCHED , MAXCONS=4 . MAXIMUM OF FOUR CONNECTIONS. 

CLASS, SC=A. DEFINE THREE SELECTION CLASSES 

CLASS, SC=B. WITH IDENTICAL CRITERIA, 

CLASS, SC=C. ALLOWS UP TO 3 CONNECTIONS PER PID. 

.ELSE, LI. 

* 

.* DEFAULT DIRECTIVES FOR NOS NAM VARIANT 
* 

SCHED , MAXCONS=4 . 

CLASS , SC=A, FSI=1 . . 4 . 

CLASS , SC=B , FSI=1 . . 6 . 

CLASS , SC=C , FSI=1 . . 6 . 

CLASS, SC=D,FSI=7,MAXIMUM=1. AT MOST ONE LARGE FILE. 

DISABLE, SC=D,PID=M03. NEVER ALLOW LARGEST FILES TO M03 . 

.IF, (TIME. GT. 0700) .AND. (TIME. LT . 1700) , PRIME. 

INCLUDE, F=PRIME. MUST BE LAST DIRECTIVE 

.ELSE, PRIME. 

INCLUDE , F=OFF . MUST BE LAST DIRECTIVE 

.ENDIF, PRIME. 

.ENDIF,L1. 

.DATA, PRIME 

. PRIME-HOURS PARAMETERS 

. ENTER "K. INCLUDE, F=PRIME." TO CHANGE NAM PARAMETERS 
DISABLE, SC=D. NO LARGE FILES DURING PRIME TIME. 
ENABLE, SC=B,PID=M03. PERMIT MEDIUM FILES TO MO 3 . 
ENABLE , SC=C , PID=M03 . 
.DATA, OFF 

. OFF-HOURS PARAMETERS 

. ENTER " K. INCLUDE, F=OFF. " TO CHANGE NAM PARAMETERS 
ENABLE ,SC=D. ALLOW LARGE FILES EXCEPT TO M0 3. 
DISABLE, SC=B,PID=M03. DISALLOW MEDIUM FILES TO M03 . 
DISABLE , SC=C , PID=M03 . 



Figure 10-6. Procedure File Example 
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Introduction 

The Mass Storage Extended Subsystem (MSE) is the product consisting of the 7990 
hardware, the channel interface, the diagnostics, and the operational software. 

The 7990 hardware is a large-capacity online mass storage device, which is a cost-effective 
extension to the disk file storage system and an alternative to other types of magnetic tape 
storage- Storing files on the 7990 retains the security, data integrity, and online access 
capabilities provided by disk and reduces the operational and data integrity problems 
caused by storing, retrieving, and mounting tape volumes. 

The 7990 hardware is composed of the following components: 
Component Description 



Cartridge for A plastic housing that encloses magnetic tape on which data is stored 

the 7990 under program control. This cartridge is compatible with an IBM 3850 

cartridge. Even though a cartridge for the 7990 is a type of magnetic 
tape, this manual reserves the terms tapes and magnetic tapes to 
reference both reel magnetic tapes and the cartridge tapes for ACS and 
CTS; tapes and magnetic tapes references never include cartridges for 
the 7990. 

7991 Storage The hardware unit that houses up to 312 usable data cartridges. The 

Module (SM) SM also consists of the cartridge accessor unit, which picks cartridges 

from and puts cartridges in their cubicles, and one or two data 
recording drives (DRD), which read data from and write data to the 
cartridges. The cubicles are assigned coordinate locations that are 
identified by the ordered pair (y,z), where the z axis is horizontal and 
the y axis is vertical. 

7990 Control The hardware unit that is the controller for up to four 7991 SMs. The 

Unit (CU) CU acts like a tape controller for up to four IBM channel interfaces and 

includes one or two data recording controllers (DRCs). The MSE 
software supports up to two IBM channel interfaces per CYBER 
mainframe. 



To protect files from hardware and system failures, you can store copies of the same files on 
both cartridges for the 7990 and magnetic tapes. You cannot, however, use the 7990 
hardware and optical disk to store copies of the same files. 
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MSE Utilities 

The basic function of MSE is to store data on the 7990 and move it to disk upon request for 
access by an authorized user. Control of file movement between a disk and a 7990 is 
transparent to the applications programmer; however, there are operational changes and 
additions that site personnel should note. These include modifications to operational 
procedures in the areas of permanent file backup, permanent file recovery, and disk space 
management. In addition, new MSE utilities are introduced. Detailed information about the 
call and operation of each MSE utility, listed next, is included in this section. 



Utility 



Description 



SSDEF Creates the system files (SM maps and 7990 catalogs) necessary for 

MSE processing. 

SSLABEL Manages allocation of cubicles and assignment of cartridges in the SM. 

SSMOVE Controls the destaging of files (creating 7990 images) and the release of 

disk space. 

SSVAL Controls the release of 7990 space and analyzes the SM maps, 7990 

catalogs, and PFC entries to identify and flag discrepancies within 
these three components. 

SSUSE Provides reports on the assignment and availability of cartridges and 

cubicles within an SM. 

SSDEBUG Corrects error conditions detected by SSVAL and recovers data from 

7990 cartridges. 

SSBLD Builds the unit device table (UDT) for SSEXEC. The UDT describes the 

7990 hardware configuration. 

SSALTER Provides dynamic modification of the 7990 hardware configuration. 
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Utility Description Terminology 

Review the following terms; they are denned as used in the descriptions of the MSE utilities 
later in this section. 

Cartridge 

A cartridge is the 7990 storage component consisting of magnetic tape. The 7990 hardware 
always writes or reads 6652 8-bit byte records, called stripes, to or from the magnetic tape. 
Each cartridge has 27,087 stripes. The first 20 stripes contain a manufacturer's label. The 
second 20 stripes contain a 7990 cartridge label written by the SSLABEL utility. The 
remaining 27,047 stripes are organized into software-defined allocation units (AUs) of 14 
stripes each for a total of 1931 AUs per cartridge. 

An allocation unit is the smallest allocatable portion of a cartridge. One or more AUs may 
be allocated to contain data for a single file. The allocated AUs for each file are organized 
into volumes (definition follows), which are chained together in the 7990 catalog to identify 
the sequence of AUs that must be accessed in order to read a file. A head-of-chain (HOC) 
flag identifies the first volume in the chain, a link field identifies the next volume in the 
chain, and an end-of-chain (EOC) flag identifies the last volume in the chain. 

The addition, removal, and reassignment of cartridges are managed by the MSE utilities. 
The cartridge labels, and also the 7990 catalogs and SM maps (definitions following), contain 
information concerning the location and content of the cartridges. The descriptions of the 
MSE utilities later in this section contain further information on cartridge management. 

SMMap 

An SM map is a direct access permanent file that contains information indicating how 
cubicles in an SM are assigned to a family and identifying the cartridges that reside in the 
SM. There is one SM map for each SM in the configuration. The permanent file name of the 
SM map is SMMAPi, where i is the SM identifier (a letter from A to H); its user index is 
377760 8 ; and its family is the default family on the mainframe on which SSEXEC executes 
(refer to the definition of SSEXEC later in this section). 

An SM map contains an entry for each possible coordinate pair (y,z) that identifies a cubicle 
in the SM, from (0,0), which is bottom left, to (21,15), which is upper right. Certain 
coordinate pairs are reserved for customer engineering use, system use, and diagnostic 
purposes. 
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Each entry in an SM map has this format: 



59 


53 


47 


41 







code 


ord 


familyname 


Wi 


sub- 
family 


id 


unused 


cm 


csn 



Field 



code 



ord 

familyname 

I 

subfamily 

id 
cm 



csn 



Description 



Number from to 6 indicating how the cubicle is assigned. 
code Description 




1 
2 
3 
4 
5 
6 



Unassigned. 

Reserved for customer engineer. 

Reserved for system use. 

Reserved for a different SM map. 

Assigned to the cartridge scratch pool. 1 

Assigned to a subfamily. 

No cubicle exists at these coordinates. 



Ordinal for this cubicle in the 7990 catalog of the subfamily to which 
the cubicle is assigned. This ordinal is referred to as the FCT ordinal 
(refer to the definition of 7990 catalog, next). This field is meaningful 
only if code=5. 

The 7-character name, in 6-bit display code, of the family to which the 
cubicle is assigned. This field is meaningful only if code=5. 

Linkage error flag that is set by the SSVAL utility when an SM map 
entry of a cubicle assigned to a family has no corresponding entry in 
the 7990 catalog. 

Number from to 7 identifying the subfamily to which the cubicle is 
assigned. This field is meaningful only if code=5. 

Letter from A to H identifying the SM. 

Cartridge manufacturer code. 



cm 



Description 



A- Cartridge manufacturer is IBM. 

B- Reserved for future cartridge manufacturer. 

The 8-character cartridge serial number of the cartridge assigned to 
the cubicle. If no cartridge is assigned, this field contains spaces. 



The zero entry in the SM map is the map header entry. In this entry the code field is 6, the 
leftmost 6 bits of the second word contain the SM identifier, and the rema inin g bits contain 
the permanent file name of the SM map. 



1. The pool is an area of the SM that stores scratch cartridges managed by the SSLABEL utility. 
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The SM map is updated whenever the SSLABEL, SSVAL, or SSDEBUG utility causes a 
change in cubicle or cartridge assignment. It is recommended that the SM map be backed 
up after every update to avoid problems such as: 

• Mismatches between SM map and 7990 catalog entries 

• Lost SM maps because of a disk failure or other problem 

• Attempts to access cartridges that are no longer available 

• Attempts to store cartridges in cubicles that are no longer empty 

Thus, you should make a copy of the SM map on tape or another device or family in order to 
retain the latest version of the SM map. If a device containing SM maps is reloaded, the 
latest version of the SM maps should be recovered from the backup copy after the reload is 
completed. After recovering the SM maps, you should run the SSVAL utility to check that 
the entries in the SM maps and 7990 catalogs match. If there are inconsistencies, corrective 
action should be taken as described under Error Conditions and Corrective Actions later in 
this section. 

7990 Catalog 

A 7990 catalog is a disk-resident direct access permanent file that contains information 
describing which allocation units of each cartridge assigned to a particular subfamily are 
allocated to 7990 files and which AUs are available for allocation. There is one 7990 catalog 
for each subfamily of a family that can have 7990-resident files, and it resides on the master 
device for the subfamily. The permanent file name of the 7990 catalog file is SFMCATi and 
its user index is 37776i 8 , where i is the subfamily identifier (a number from to 7). For 
example, file SFMCAT3 and user index 377763 8 identify the 7990 catalog for subfamily 3. 

A 7990 catalog is partitioned into subcatalogs, one subcatalog for each SM used by the 
subfamily. The maximum number of subcatalogs in a 7990 catalog is eight (the maximum 
number of SMs in a configuration). Each subcatalog consists of two parts, the file and 
cartridge table (FCT) and the allocation summary table (AST). The FCT has an entry for 
each cartridge assigned to the subfamily from the given SM. The maximum number of FCT 
entries in a subcatalog is 312 (the maximum number of cartridges in an SM). The AST 
contains information used by the allocation algorithm to select the cartridges on which a file 
will reside. 
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The first part of the 7990 catalog contains a header and at most eight subcatalog entries. 
The header identifies the family and subfamily of the 7990 catalog. Each subcatalog entry 
contains the length and location of its FCT and AST, the SM identifier, unallocated AUs 
available for small and large files, and the date and time of the last SSVAL run that 
resulted in the release of 7990 space assigned to orphan files. The format of the header is: 



59 






17 


11 


2 


family name 


sub-: 
family 


?///////. 


id 






unused 










unused 







Field 



Description 



familyname The 7-character name, in 6-bit display code, of the family for this 7990 

catalog. 

subfamily Number from to 7 identifying the subfamily for this 7990 catalog. 

id Number identifying this file as a 7990 catalog file, id is set to 1. 



The format of the subcatalog entry is: 



59 


53 


47 




41 


35 


26 


17 


11 





id 


length 


FCT loc 


ASTIoc 


unused 


unused 


1 


date time 






AUs small 




AUs large 


J AUs group 


unused 



Field 



Description 



id SM identifier for the subcatalog (a letter from A to H). 

length Number of FCT (and AST) entries in the subcatalog. 

FCT loc Location (beginning PRU number) of the FCT. 

AST loc Location (beginning PRU number) of the AST. 

date time Date and time of the last releasing of orphan files on the SM identified 

by id. 

AUs small Total number of free AUs available for small files on all cartridges in 

thisSM. 

AUs large Total number of free AUs available for large files on all cartridges in 

this SM. 
AUs group Maximum number of free AUs available within one group in this SM. 
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Each cubicle from the given SM assigned to the subfamily has an entry in the FCT of the 
subcatalog. This entry contains the coordinates (y,z) of the assigned cubicle. If a cartridge 
has been assigned to the cubicle, the FCT entry also contains the csn of the cartridge, usage 
information, status flags, and information about each of the AUs of the assigned cartridge. 
The format of each FCT entry is: 



59 


56 53 51 


47 




41 


35 


32 


29 


17 




11 


2 


csn 


cm 


v 1 .... 


first All large 


first AU small 


flags 


ord 




od ? 


od 2 


od 1 


first 
stripe 


stripe 


pru 


max AUs 


cdp 


odu 


unused 


unused 


flawed AU 


read stripe count 


write stripe count 




soft read error 


soft write error 


hard read error 


demarked stripe 


load count 


load error 


cartridge link 


cartridge link 


• 
• 
• 




cartridge link 


cartridge link 





Field 



Description 



csn 



cm 



The 8-character cartridge serial number, in 6-bit display code, of the 
cartridge assigned to this cubicle. If no cartridge is assigned, this field 
contains spaces. 

Cartridge manufacturer code. 



cm 



Description 



A- Cartridge manufacturer is IBM. 

B- Reserved for future cartridge manufacturer. 



y 

z 

first AU large 

first AU small 



y coordinate of this cubicle. 

z coordinate of this cubicle. 

First free AU available for large files in this cartridge. 

First free AU available for small files in this cartridge. 
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Field Description 



flags One of the following flags: 
Bit Description 



17 Inhibit allocation flag indicating that space from the 

cartridge assigned to this cubicle is not to be allocated to a 
file. This flag is set or cleared by a directive to the 
SSLABEL utility. 

16 Lost cartridge flag indicating that the cartridge assigned to 

this cubicle was not there the last time SSEXEC tried to 
pick it. This flag can be cleared by a directive to the 
SSLABEL utility. 

15 Excessive write parity error flag set by SSEXEC when an 

error threshold has been passed. Space from this cartridge 
is not to be allocated. This flag can be cleared by a directive 
to the SSDEBUG utility. 

14 Linkage error flag indicating that the SM map entry for the 

location (y,z) is inconsistent with the FCT entry. This flag 
is set by the SSVAL utility and cleared by the SSDEBUG 
utility. 

13 Free cartridge flag. When this flag is set, SSEXEC inhibits 

further allocation. Files can be removed by running the 
SSVAL utility. This flag is set or cleared by a directive to 
the SSLABEL utility. 

12 Eeserved. 

ord Ordinal of the FCT entry in the subcatalog. 

oc l. Off-cartridge link specifying the ordinal of the FCT entry for the cubicle 

containing the next cartridge on which the file on the cartridge assigned 
to this cubicle resides. If a file does reside on multiple cartridges, the 
entire file must be contained within a 16-cartridge group. Also, since 
there are only three off-cartridge link fields, if a cartridge contains 
several files, only three can be contained on other cartridges. 
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Field 



Description 



first stripe 

stripe 

pru 

max AUs 
cdp 



oclu 



flawed AU 

read stripe 
count 

write stripe 
count 

soft read error 

soft write error 

hard read error 

demarked stripe 

load count 

load error 



First usable stripe following the cartridge label. This field is set to 40. 

Number of stripes in each AU. This field is set to 14. 

Number of PRUs that can be written on each stripe. This field is set to 
13. 

Maximum number of AUs in a cartridge. This field is set to 1931. 

Cartridge division point between small and large files kept on the same 
cartridge. The cartridge division point is defined with the B=n 
parameter to an SSLABEL directive. The default is B=600, specifying 
that the first 600 AUs of a cartridge are available for small files. 

Off-cartridge link usage field. When an oclj field is used, a 
corresponding bit is set in this field. Bit is set for ocl^ bit 1 is set for 
ocl 2 , and bit 2 is set for ocl 3 . 

Number of flawed AUs on this cartridge. 

Accumulated number of stripes read from this cartridge. 

Accumulated number of stripes written to this cartridge. 

Accumulated number of soft read errors detected on this cartridge. 

Accumulated number of soft write errors detected on this cartridge. 

Accumulated number of hard read errors detected on this cartridge. 

Accumulated number of stripes demarked on this cartridge. 

Accumulated number of times this cartridge has been loaded for a 
read/write operation. 

Accumulated number of cartridge load errors detected using this 
cartridge. 
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Field Description 



cartridge link There is a 30-bit cartridge link field for each AU in the cartridge. The 
bits are divided into the same fields and represent the same 
information for each AU. 



Bit(s) Description 



29 Free/busy flag indicating whether or not this AU is 

currently allocated to a file. 

28 Unused. 

27 AU conflict flag indicating an allocation conflict involving 

this AU. This flag is set by the SSVAL utility or by 
SSEXEC. 

26 Frozen chain flag indicating a problem with this allocation 

chain. This flag is set by the SSVAL utility or by SSEXEC. 
This AU is not reused until this flag is cleared by a 
directive to the SSDEBUG utility. 

25 Start of fragment flag indicating this AU is the be ginning 

of a chain fragment. 

24 Flawed AU flag indicating this AU is not to be allocated to 

a file. 
23 Continuation AU flag indicating whether or not this AU is 

the first AU of a volume. If this flag is clear, the AU is the 

first AU of the volume; if set, the AU is not the first AU of 

the volume. 

22-21 Off-cartridge link field indicating that the next volume of 

the file is on another cartridge. The next cartridge is 
identified by one of the oclj fields. The value of the 
off-cartridge link flag (1, 2, or 3) specifies which oclj field to 
use. The link field specifies the number of the first AU on 
the next volume of the file. This field is meaningful only if 
the chain control field indicates that this volume is the first 
or middle volume of the file. 

20-19 Chain control field indicating whether this volume is the 

first (1), last (2), only (3), or middle (0) volume of the file. 

18-12 File length field indicating the number of AUs in the file 

following the first accessed AU. 

11-0 Link field indicating the first AU on the next volume of the 

file. If the continuation AU flag is clear, this field contains 
the ordinal of the first AU of the volume. If the 
continuation AU flag is set, this field contains the ordinal of 
the first AU within the volume. 
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The 7990 catalog is updated whenever the SSLABEL, SSMOVE, SSVAL, or SSDEBUG 
utility causes a change in cartridge or cubicle assignment that affects the subfamily. 
Because the 7990 catalog for a subfamily resides on its master device, it will be backed up 
by PFDUMP whenever the master device for the subfamily is dumped. Consequently, when 
PFLOAD reloads all files, the 7990 catalogs are automatically recovered and all 
7990-resident files as indicated in a recovered PFC will also have entries in the recovered 
7990 catalog. Thus, no special operational procedures are needed to back up a 7990 catalog. 
It is possible, however, that the 7990 catalog will be inconsistent with the SM maps or 
cartridge labels. If such inconsistencies do exist, corrective action will have to be taken as 
described under Error Conditions and Corrective Actions later in this section. 



7990 Files 

In an MSE environment, permanent files can be categorized according to whether or not 
they reside on 7990. A disk file is a permanent file that resides on disk but not on 7990. A 
7990 file is a permanent file that resides on 7990 and may or may not also reside on disk, 
depending on how the disk space is managed (refer to Disk Space Management later in this 
section). Depending on backup requirements (BR parameters), both disk and 7990 files can 
also have backup images on tape (refer to the NOS Version 2 Reference Set, Volume 3). 

When a user defines a direct access file, initially it is a disk file. A disk file becomes a 7990 
file when it is destaged to 7990; that is, an image of the file is created on 7990. Files are 
destaged through use of the SSMOVE utility, which is run periodically to manage disk 
space. When SSMOVE is run, files are destaged to 7990 and/or their disk space released 
depending on certain file characteristics (refer to SSMOVE later in this section). Thus, after 
an SSMOVE run a file can reside on disk, on 7990, or on both. If the file does have a 7990 
image, the asa field in the PFC entry for the file indicates the location of the 7990 copy. 

When a user attaches a 7990 file, it is staged to disk from 7990 (that is, a disk image is 
created) if the file is not on disk. If a direct access file is attached in write mode, the AFOBS 
flag is set in the PFC entry for that file. The current version of the file resides on disk only. 
If an indirect access file is replaced or appended to, the asa field is cleared in the PFC entry 
for that file. Setting the AFOBS flag or clearing the asa in the PFC ensures that the current 
version of the file will be copied to 7990 when that file is again selected for being released 
from disk. 

If the file is purged, its disk space, but not its 7990 space, is immediately released. The 
SSVAL utility must be run to release 7990 space allocated to purged files. Thus, because a 
purged file has no PFC entry linking to its 7990 catalog entry, the 7990 image that still 
exists before SSVAL is run is called an orphan file. However, a user can never access an 
orphan file. 

When a file is destaged to 7990, control information is written on each stripe to which the 
file data is written. This information is sufficient to identify the file. 
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SSEXEC 



SSEXEC is the main processing program that is responsible for controlling MSE activities. 
The MSE utilities issue requests to SSEXEC to destage files from disk to 7990, purge 
unneeded 7990 files, label or relabel cartridges, update SM maps and 7990 catalogs, and so 
forth. In a multimainframe environment, two versions of this program exist: the mainframe 
to which the 7990 device is physically connected (the master mainframe) has a program 
called SSEXEC, and all other mainframes (the slave mainframes) have a program called 
SSSLV. Refer to section 13, Multimainframe Operations, for more information. 

Subfamily 

Each permanent file family consists of eight subfamilies, subfamily through subfamily 7. 
The lower 3 bits of the user index identify the subfamily to which a user belongs. For 
example, a user whose index ends in 3 (or Oil in bit notation) belongs to subfamily 3. When 
the SSDEF utility is run to create MSE system files, the SM maps are created on the 
master device under user index 377760 8 (subfamily 0) and one 7990 catalog is created under 
each user index 37776i 8 (subfamily i), i=0,l,2,...,7. When the SSLABEL utility is used to 
assign an SM, cubicle, or cartridge to a family, it is possible to specify assignment to 
particular subfamilies of the family. 

Group 

A group is a software-defined structure for allocating cartridges within a subfamily. A group 
of cartridges is a number of cartridges (up to 16) in which files belonging to a subfamily can 
reside. Any file can overflow from one cartridge in a group to any other cartridge in the 
same group. However, no file can overflow from a cartridge in one group to any cartridge in 
another group. Cartridges are placed in or removed from specific groups by using the 
SSLABEL utility. The SSVAL utility compares the 7990 catalogs (for each subfamily) with 
the same information obtained from the PFC entries. 

Volume 

A volume is a software-defined structure used to simplify the allocation and access of large 
7990 files. Up to 128 consecutive AUs in a cartridge that have the same status (either 
allocated or not allocated) are considered to belong to the same volume. These consecutive 
AUs are composed of stripes that all have the same volume serial number (a physical 
identifier that is written to the tape on the cartridge). The MSE software fills cartridges 
(unallocated volumes) from the beginning to the end with no rewinding. This action 
minimizes repositioning of the tape in a cartridge for multivolume files. 

When a file is staged back to disk, the control information on each stripe is verified. If a 
discrepancy is detected, an error message is issued, the file stage is aborted, an error flag is 
set in the PFC entry to indicate that the 7990 file could not be accessed, and the AU conflict 
flag is set in the 7990 catalog entry for the particular cartridge(s) and AU(s). 
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MSE Utilities 

MSE utilities are described next. All of these utilities must be run from system origin jobs. 
In a multimainframe environment, the SSDEF, SSUSE, and SSBLD utilities can be run on 
any mainframe that has access to the family being processed. However, the remaining 
utilities must be run on the mainframe on which SSEXEC executes. 



SSDEF 

SSDEF creates the system files (SM maps and 7990 catalogs) that are necessary for MSE 
processing. If an SM is added to the 7990 hardware configuration, SSDEF is used to create 
the SM map for that SM. If a family is to be permitted to have 7990-resident files, SSDEF is 
used to create the eight 7990 catalogs for that family (one catalog for each subfamily). 

NOTE 



If the SM parameter is specified, SSDEF will create an SM map for the specified SM (refer 
to the definition of SM map earlier in this section). It is recommended that the SM map be 
copied on tape or on another device or family immediately after it is created. 

The format of the SSDEF command is: 

SSDEF, p 1 ,p 2 . 

Pj Description 

FM=familyname Family for which 7990 catalogs are to be created, one catalog for each 
subfamily. 

FM Same as FM=system default family. 

FM omitted No 7990 catalogs are to be created. SM=id or SM must be specified. 

SM=id SM identifier of the SM for which an SM map is to be created; id is a 

letter from A to H. 

SM Same as SM=A. 

SM omitted No SM map is to be created. FM=familyname or FM must be specified. 

Example: 

SSDEF, SM=B. 

SMMAPB, the SM map for SM B, is created, and its entries are as described in the previous 
definition of SM map earlier in this section. However, since SSDEF does not assign cubicles, 
the entries for cubicles available for use initially indicate that the cubicles are unassigned. 
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SSLABEL 



SSLABEL manages cartridge assignment and cubicle allocation in an SM. The following 
functions are performed through use of directives to SSLABEL. 

Add an SM to a subfamily (AS directive). 

Remove an SM from a subfamily (RS directive). 

Add cubicles to a subfamily, the pool, or the reserved area (AB directive). 

Remove cubicles from a subfamily, the pool, or the reserved area (RB directive). 

Add cartridges to a subfamily or the pool (AM directive). 

Remove cartridges from a subfamily or the pool (RM directive). 

Restore an abnormally removed cartridge (RC directive). 

Repair a cartridge label or overwrite a family label (FX directive). 

Inhibit or allow further allocation of files to a cartridge (IB directive). 

Initiate freeing all files from an existing cartridge (FC directive). 

Input to SSLABEL is via a directive file. SSLABEL reads the appropriate SM maps and 
7990 catalogs to determine how to process each directive and then issues requests to 
SSEXEC to read and/or write cartridge labels and to update the SM maps and 7990 
catalogs. SSLABEL generates a report detailing the action taken for each input directive. If 
the assignment information or cartridge label is not appropriate or conflicts with data in the 
SM map or 7990 catalog, the cartridge label information is included on this report and the 
cartridge is put into the exit tray. It may be possible to restore such a cartridge, as 
described under Cartridge Restoration and Reuse later in this section. 



NOTE 



SSLABEL updates the SM map for the specified SM (refer to the definition of SM map 
earlier in this section). It is recommended that the SM map be copied on tape or on another 
device or family immediately after each update. 
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The format of the SSLABEL command is: 

SSLABEL , p a , p 2 . 

Pi Description 



I=filename File containing the directives to SSLABEL. 

I Same as I=INPUT. 

I omitted Same as I=INPUT. 

L=filename File on which listable output is to be written. 

L Same as L=OUTPUT. 

L=0 No output file is to be generated. 

L omitted Same as L=OUTPUT. 

Z Directives are contained on the SSLABEL command. The I parameter 

is ignored. 

Z omitted Directives are contained on the file specified by the I parameter. 

SSLABEL Directives 

The directives to SSLABEL can be specified on a separate file (specified by the I parameter) 
or after the SSLABEL command (Z specified). If on the input file, each directive must be 
specified on a separate line using the OP=directive option. Parameters for a directive are on 
the same line, are separated by commas, and end with a period: 

OP=directive / p 1 ,p 2 , . . . ,p n . 

Example 1: 

SSLABEL , I=DIRFILE . 

DIRFILE is the directive file; it contains the following directives: 

0P=AM,N=4,PK=D. 

OP=RM, CN=44455566 , FM, SB=1 , PK=F . 

Two directives to SSLABEL are specified. OP=AM adds four cartridges to the pool of SM A 
(SM parameter not specified). OP=RM removes the cartridge whose csn is 44455566 from 
subfamily 1 of the default family. (Refer to the following descriptions of directives and 
parameters.) 

If the directives are contained on the command, they follow the command terminator. The 
first character following the terminator is the separator. Any character that does not appear 
in any of the directives can be used as the separator character. Each directive must be 
preceded by the separator and terminated by a period. 
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Example 2: 

SSLABEL , Z . /OP=AM, N=4 , PK=D. /OP=RM, CN=44455566 , FM, SB=1 , PK=F . 

The slant is used as the separator. This command performs the same functions as those in 
the preceding example. 

The following directives are available with SSLABEL. Some of these directives cause 
cartridges to be physically moved to and from cubicles and the input or exit tray (refer to 
OP=AM, OP=RM, OP=RC, and OP=FX in the following paragraphs). The remaining 
directives cause only logical operations to occur, updating the MSE system files. 
Descriptions of the parameters for these directives follow the directives. 

OP=AS—AddSMs 

OP=AS adds an SM to a subfamily. The 7990 catalog for the specified subfamily is updated 
to reflect that cartridges and permanent files for the subfamily can reside on the specified 
SM. This directive, however, does not manipulate cartridges or cubicles. 

OP=RS — Remove SMs 

OP=RS removes an SM from a subfamily. The 7990 catalog for the specified subfamily is 
updated to reflect that cartridges and permanent files for the subfamily cannot reside on the 
specified SM. Before OP=RS can be specified, all cubicles in the specified SM must have 
been removed previously from the family (refer to the OP=RB directive). This directive, 
however, does not manipulate cartridges or cubicles. 

OP=AB —Add Cubicles 

OP=AB adds an unassigned cubicle within an SM to a subfamily (PT=F), the pool (PT=P), or 
the reserved area of the SM (PT=R). More than one cubicle (N=n) can be added at a time. 
Specific cubicles (YI and ZI parameters) can be added, but they must be currently 
unassigned. For PT=R, YI and ZI must be used to add multiple cubicles; N=n is not valid. 
The SM map is updated to reflect the new assignment of cubicles. When PT=R is specified, 
the cubicle is reserved to a different SM map. Cubicles reserved for system use, storage 
module maintenance, or customer engineering use are reserved at compile time. Cubicles 
assigned to the pool are not assigned to a family or subfamily. 

OP=RB — Remove Cubicles 

OP=RB removes an assigned empty cubicle from a subfamily (PK=F), the pool (PK=P), or 
the reserved area of the SM (PK=R). More than one cubicle (N=n) can be removed at a time. 
SSLABEL reads the SM map and selects the first empty cubicle assigned to the subfamily, 
pool, or reserved area to be removed. Specific cubicles (YI and ZI parameters) can be 
removed, but they must be empty. The SM map is updated to reflect that the cubicles are 
unassigned. 
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OP=AM — Add Cartridges 

OP=AM adds a cartridge to either a specific subfamily (PT=F) or the pool (PT=P). SSLABEL 
selects the first empty cubicle assigned to the subfamily or pool as the new location for the 
cartridge. More than one cartridge (N=n) can be added at a time or a specific cartridge 
(CN=csn) from the pool can be added to a subfamily. The SM map, 7990 catalog, and 
cartridge label are updated to reflect the new assignment of the cartridge. Cartridges added 
to a subfamily may be added to a specific group using the GR=n parameter. If cartridges 
are added to the pool, the GR=n parameter is not valid. The small and large boundaries for 
file size are specified by the B=n parameter with the OP=AM option. Default is B=600, 
implying that the first 600 AUs of the cartridge are available for small files. Cartridges 
added to the pool are not assigned to a family or subfamily. A customer engineer cartridge 
can be stored into location (0,0) or (0,15) by using the CC=loc parameter. 



OP=RM — Remove Cartridges 

OP=RM either removes an empty cartridge from a subfamily (PK=F) and moves the 
cartridge to the pool (PT=P) or it moves any cartridge from the pool (PK=P) and moves it to 
the exit tray (PT=D). Any cartridge currently assigned to a subfamily cannot be removed 
unless it is empty; that is, all AUs must be unallocated. To remove a cartridge that is not 
empty, first use the OP=FC directive to free up the cartridge. 

If the cartridge specified by the CN=csn parameter is lost (does not reside in its assigned 
cubicle) and if the cartridge is assigned to a family, the LT parameter should be specified. 
This allows the appropriate entries in the SM map and 7990 catalog to be deleted even 
though the cartridge is not available to have its label updated. If LT is not specified, an 
error message is issued and SSLABEL aborts. SSLABEL will not update the SM map and 
7990 catalog with the LT parameter unless the lost cartridge flag is set in the 7990 catalog. 
SSLABEL will set the lost cartridge flag if SSLABEL is run to remove a cartridge that is 
not present. 

If the cartridge specified by the CN=csn parameter is lost and it is in the pool, then the LT 
parameter should not be used. Rather, SSDEBUG must be run to remove the SM map 
entry and SSLABEL must be run to reassign the cartridge to the pool. 

A specified number (N=n) of cartridges may be removed from a group of a subfamily by 
using the GR=n parameter. 



OP=RC — Restore Lost Cartridges 

OP=RC restores to its proper cubicle a cartridge that was inadvertently removed from an 
SM. If restoration is successful, the lost flag in the 7990 catalog is cleared. If data recorded 
on the cartridge label does not agree with the information in the 7990 catalog and the SM 
map entry for the cubicle to which the cartridge is to be restored, the cartridge label 
information is reported and the cartridge is put into the exit tray for use in further 
processing of the cartridge. 

NOTE 

Not more than one lost cartridge can be restored at a time using the OP=RC directive. Also, 
since customer engineer cartridges do not exist in the SM map, OP=RC will not restore a 
cartridge to a customer engineer cartridge cubicle. 
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OP=FX — Fix Cartridge Labels 



OP=FX writes a scratch label on a cartridge identified by the CN=csn parameter and adds 
the cartridge to the pool. This directive is intended for use when a cartridge label has been 
destroyed, but the cartridge itself is not physically damaged and can be reused. It can also 
be used when a cartridge with a family label is to be assigned to a different subfamily using 
the OP=AM directive, but it is not feasible to first remove the cartridge normally using the 
OP=RM directive. For example, if SSLABEL is run to add a cartridge to a subfamily, and a 
system failure occurs before the 7990 catalog and SM map are updated but after the 
cartridge is relabeled, then the cartridge label does not match the corresponding entries in 
the 7990 catalog and SM map. Hence, OP=RM cannot be used to remove the cartridge from 
the subfamily, but OP=FX can be used to rewrite the cartridge label and then OP=AM can 
be used to add the cartridge to a subfamily. However, if a family label is to be overwritten, 
the FM=familyname and SB=subfamily parameters must identify the family and subfamily 
to which the cartridge was assigned. The SM map and 7990 catalog are updated to reflect 
the new cartridge label. 

OP=RM cannot be used with the LT parameter to remove pool cartridges. SSLABEL sets 
the SM map error flag because no 7990 catalog entries exist for pool cartridges. Use 
SSDEBUG to remove pool cartridges. 

OP=IB — Control Cartridge Allocation 

OP=IB sets or clears the inhibit allocation flag in the 7990 catalog entry for the specific 
cartridge (CN=csn). If the flag is set (ON), SSEXEC does not allocate new 7990 files to this 
cartridge. If the flag is cleared (OF), allocation of files to this cartridge is enabled. 

OP-FC — Free Cartridge Files 

OP=FC sets or clears the free cartridge flag in the 7990 catalog entry for the specified 
cartridge (CN=csn). If the flag is set (ON), SSEXEC will inhibit further allocation. Files can 
be removed by running the SSVAL utility. Refer to the free cartridge discussion under 
SSVAL later in this section. If the SM map entry is missing, SSDEBUG must be used to set 
the free cartridge flag. Refer to the discussion under SSDEBUG later in this section. 
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Parameters for SSLABEL Directives 

The descriptions of the parameters to the SSLABEL directives follow. Not all parameters 
are valid with all directives, as indicated. 



Pi 



Description 



B=n 



B omitted 
CC=loc 



Number of AUs on this cartridge to be used to store small files. The 
remaining AUs (1931-n) are reserved for large files. The distinction 
between small and large files is controlled by an assembly parameter. 
B=n is valid only with OP=AM. 

Same as B=600. 

Location into which the cartridge is to be stored. 



loc 



Description 



A 
B 



Store cartridge into location (0,0). 
Store cartridge into location (0,15). 



CM=A- 

CM 

CM omitted 

CN=csn 

CN 

CN omitted 

FM=familyname 

FM 

FM omitted 

GR=n 

GR 

GR omitted 



Any value of CC other than A or B is not accepted. 

Cartridge manufacturer code is A— indicating IBM. 

Same as CM=A-. 

Same as CM=A- 

Cartridge serial number of the cartridge to be added, removed, or 
repaired; not valid if PK=pkloc is specified. If CN=csn is specified, n 
must be 1 if N=n is specified. 

Cartridge serial number of the cartridge is not specified. 

Same as CN. 

Family to which SSLABEL adds or from which it removes a cartridge 
or SM. With OP=FX, this parameter specifies the family to which the 
cartridge was assigned. 

Same as FM=system default family. 

Same as FM=system default family. 

Group to which SSLABEL adds or from which it removes a cartridge; 1 
< n < 20. With OP=AM, this parameter is ignored if PT=P is specified. 
GR=n is valid only with OP=AM or OP=RM. 

Not permitted. 

Default groups are chosen sequentially. SSVAL runs most efficiently if 
SSLABEL chooses the default groups. 
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Pi 



Description 



LT SM map and 7990 catalog entries are to be updated, even though the 

cartridge is lost and its label cannot be updated; valid only with 
OP=RM. 

LT omitted If the cartridge is lost and OP=RM is specified, an error message is 

issued and SSLABEL aborts. 

N=n Number of cartridges or cubicles to be added, removed, or repaired; 1 < 

n < 100; not valid if PT=R is specified. If CN=csn is specified, n must 
bel. 

N Same as N=l. 

N omitted Same as N=l. 

OF The inhibit allocation flag or free cartridge flag in the 7990 catalog is to 

be cleared; valid only with OP=IB or OP=FC. 

ON The inhibit allocation flag or free cartridge flag in the 7990 catalog is to 

be set; valid only with OP=IB or OP=FC. 

PK=pkloc Location from which the cartridge or cubicle is to be picked; not valid if 

CN=csn is specified. 



pkloc 



Description 



D 



R 



Cartridge is to be picked from the input tray. PK=D is 
valid only with OP=AM, OP=RC, or OP=FX 

Cartridge or cubicle is to be picked from the specified 
family (FM=familyname) and subfamily (SB=subfamily). 
PK=F is valid only with OP=RM or OP=RB. 

Cartridge or cubicle is to be picked from the pool. PK=P is 
valid only with OP=AM, OP=RM, or OP=RB. PK=P is not 
valid if PT=P is specified. 

Cubicle is to be picked from the reserved area of the SM. 
PK=R is valid only with OP=RB. 



PK 

PK omitted 



Same as PK=P. 
Same as PK=P. 
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Pi 



Description 



PT=ptloc 



Location into which the cartridge or cubicle is to be put. 



ptloc 



D 



R 



Description 



Cartridge is to be put into the exit tray. PT=D is valid only 
with OP=RM. 

Cartridge or cubicle is to be put into the specified family 
(FM=familyname) and subfamily (SB=subfamily). PT=F is 
valid only with OP=AM or OP=AB. 

Cartridge or cubicle is to be put into the pool. PT=P is valid 
only with OP=AM, OP=RM, or OP=AB. PT=P is not valid if 
PK=P is specified. 

Cubicle is to be put into the reserved area of the SM. PT=R 
is valid only with OP=AB. 



PT 

PT omitted 

SB=subfamily 

SB 

SB omitted 

SM=id 

SM 

SM omitted 

Yi=yi 

ZI=Z! 

YI= yi ,ZI= Zl 



Same as PT=P. 

Same as PT=P. 

Subfamily to which SSLABEL adds or from which it removes a 
cartridge or SM; < sub < 7. With OP=FX, this parameter specifies the 
subfamily to which the cartridge was assigned. 

Same as SB=0. 

Same as SB=0. 

SM identifier of the SM to be used by SSLABEL; id is a letter from A 
toH. 

Same as SM=A. 

Same as SM=A. 

Row of the SM to be added or removed; < y x < 21; valid only with 
OP=AB or OP=RB. 

Column of the SM to be added or removed; < z x < 15; valid only with 
OP=AB or OP=RB. 

y and z coordinates of the cubicle to be added or removed; 
< y x < 21, < zj < 5; valid only with OP=AB or OP=RB. The following 
coordinates (y,z) are reserved for customer engineering and/or 
diagnostic programming purposes: (0,0), (0,6), (0,15), (11,0), (11,1), 
(11,15), (15,0), (15,1), (21,6), and (21,15). The following coordinates are 
reserved for system use: (0,1), (0,14), (21,0), and (21,14). 
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Pi Description 



YI=y 1 ,ZI=z 1 , Eectangle of cubicles to be added or removed; cubicles with y 

YF=y 2 ,ZF=z 2 coordinates between y x and y 2 and z coordinates between z x and z 2 are 

included; valid only with OP=AB or OP=RB. At most, 100 cubicles can 
be included in the rectangle. YF and ZF must both be specified, if 
either is specified. YF and ZF cannot be specified unless both YI and ZI 
are specified. If a reserved cubicle is included in the rectangle, the 
directive will be accepted even though the reserved cubicle cannot be 
added or removed. z x =6 and z 2 =6 are not valid. 

YI and ZI With OP=AB, the next available cubicle closest to the top (for 

omitted assignment to a family) or the bottom (for assignment to the pool) is to 

be selected. With OP=RB, the first empty assigned cubicle is to be 

selected. 



SSLABEL Update Sequence 

Each directive to SSLABEL updates SM maps, 7990 catalogs, and cartridge labels, 
whichever are appropriate, to reflect the changes in cartridge, cubicle, or SM assignment. 
Because the 7990 catalog is a disk-resident permanent file, it will be backed up on a dump 
tape whenever PFDUMP dumps the master device for its particular subfamily. Thus, it is 
not necessary for the analyst to back up the 7990 catalogs immediately after an SSLABEL 
run. However, the backup and recovery of SM maps do require special operational 
procedures, which should be performed immediately after an SSLABEL run (refer to the 
definition of SM map earlier in this section). 

When SSLABEL is run to change the assignment of a cartridge, the update sequence 
consists of a series of steps to delete the old assignment information from the MSE system 
files, relabel the cartridge, and add the new assignment information to the MSE system files. 
If an interruption such as a system failure, SSLABEL abort, or SSEXEC abort prevents 
SSLABEL from completing the update sequence, the location of the affected cartridge and 
the status of the SM maps and 7990 catalogs depend on the point of interruption, as follows: 

• If the cartridge label, 7990 catalog, and SM map do not all match, then the cartridge is 
put into the exit tray. The OP=RC directive cannot be used to restore the cartridge 
because of the inconsistency. However, OP=FX can be used to overwrite the cartridge 
label and add the cartridge to the pool, if the FM and SB parameters specify the family 
and the subfamily on the cartridge label. 

• If the cartridge label, 7990 catalog, and SM map do match, then the cartridge may be 
returned to its original location, the new location, or the exit tray, depending on the 
exact point of interruption. If the cartridge is in the input tray, OP=RC can be used to 
restore the cartridge to the location indicated on the cartridge label. 

Cartridge Restoration and Reuse, later in this section, describes the procedure for restoring 
cartridges found in the exit tray. 
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Restrictions to SSLABEL 

The following restrictions apply to the SSLABEL utility. 

• SSEXEC must be running when SSLABEL is run. 

• Only one copy of SSLABEL can be run at a time. 

• SSLABEL, SSVAL, and SSDEBUG cannot be run at the same time. 

SSLABEL Example 

Figure 11-1 shows the format of an SSLABEL report. The cartridge label information is 
included on the report because of a mismatch with the SM map. An error message is issued 
for the first directive on the command (in this case, the only directive). 



SSLABEL REPORT FILE 






SSLABEL , Z . /OP=RC , PK=D, SM=B . 






1 


OP=RC,PK=D,SM=B. 






1 


OP=RC,PK=D,SM=B. 

CM=A- 

CSN = 66157234 

FAMILY = SYSTST 

SUBFAMILY = 

SM = B 

Y = 2 

Z = 6 






*** ERROR 8 DIRECTIVE 1 








UNEXPECTED SM, 


Y, 


Z, FAMILY OR SUBFAM.*** 



Figure 11-1. SSLABEL Report File 
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SSMOVE 



SSMOVE manages disk and 7990 residence. That is, SSMOVE determines which files 
should be left on disk, which files should be released from disk and moved to 7990, and 
which files should be resident both on disk and on 7990. 

The selection process includes algorithms that weigh certain file characteristics, as follows: 

• Files are selected for destaging to 7990 based on file length, time since the last update, 
and the preferred residence specified by the user. 

• Files are selected for release from disk based on time since the last access and the 
backup requirement specified by the user. 

SSMOVE reads the PFC entries for a particular family and calculates release and destage 
values (refer to Selection Algorithms later in this section) for each file to determine its 
residence. If a file has both disk and 7990 images but is to reside only on 7990, SSMOVE 
releases the disk space for the file. For files that do not have a 7990 image, SSMOVE 
creates entries on the SSMOVE/SSEXEC communication file, MVOCOM, to identify the 
files to be destaged and to specify whether or not the file's disk space is to be released upon 
completion of the destage. SSEXEC then processes each destage and destage/release 
request on MVOCOM. 

SSMOVE generates an output report that includes a list of input directives to SSMOVE, 
site-defined values used in the destage/release decision-making process, files selected for 
processing, and a summary of the number of files expected to reside on each device after 
destage/release processing. 
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----P n . 



The format of the SSMOVE command is: 

SSMOVE,p 1 ,p 2 / 
_Pl 

DN=device 



Description 



DN 

DN omitted 

FM=familyname 

FM 

FM omitted 

I=filename 

I 

1=0 

I omitted 

L=filename 

L 

L=0 

L omitted 

LB=n 

LB 

LB omitted 

LO=F 

LO=P 

LO 

LO omitted 



Device number of the only disk from which files are to be 
destaged/released. 

SSMOVE destages and releases files from all devices in a specified 
family. 

Same as DN. 

Family to be used by SSMOVE. 

Same as FM=system default family. 

Same as FM=system default family. 

File containing the directives to SSMOVE. 

Same as I=INPUT. 

No input directives file exists. SSMOVE uses the default parameters. 

Same as I=INPUT. 

File on which listable output is to be written. 

Same as L=OUTPUT. 

No output file is to be generated. 

Same as L=OUTPUT. 

Large file boundary is used when sorting files for destaging. All files 
smaller than n PKUs are small files. 

Same as LB=365. 

Same as LB=365. 

All files selected for staging, destaging, or releasing are to be included 
in the report file. 

Only files actually processed are listed in the report file. Refer to the 
PX parameter. 

Individual files are not to be listed in the report file. 

Same as LO. 
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Pi 



Description 



NW 

NW omitted 

PX=xxx 



PX 

PX omitted 

UI=userindex 

UI 

UI=0 

UI omitted 



No wait. SSMOVE will not wait for completion of destage and release 
processing by SSEXEC. 

SSMOVE will wait for completion of destage and release processing by 
SSEXEC. 

xxx is a character string that specifies which types of SSMOVE 
processing should not be done. 

Description 

Exclude file archiving or releasing disk space. 

Exclude creating a backup copy by destaging a file from 
disk to the 7990. 

Exclude direct access files. 

Exclude freeing a file from the 7990 by clearing its asa 
value from the file's PFC entry. 

Exclude indirect access files. 

Exclude staging a file from the 7990 to disk. 



A 
B 

D 

F 

I 

S 



For example, the PX=ABFS parameter could be used to obtain a report 
of the results of an SSMOVE run using a given set of parameters 
without actually performing any of the selected actions. 

All selected SSMOVE processing is to be done. 

Same as PX. 

Destage and release processing is restricted to files having user index 
userindex. 

All user indexes are processed. 

All user indexes are processed. 

All user indexes are processed. 



11-26 NOS Version 2 Analysis Handbook 



60459300 U 



MSE Utilities 



SSMOVE Directives 

The directives to SSMOVE are specified on a separate file. Each directive must be specified 
on a separate line. Three types of input directives can be included in an SSMOVE directive 
file. They are: comment directives, specific file directives, and value specifier directives. 

Comment directives have an asterisk (*) in the first column followed by any message or 
comment the user wishes to enter. 

The specific file and value specifier directives are described in the following paragraphs: 

Specific File (SF) Directives 

SSMOVE uses SF directives to select a given file or set of files on which to perform the 
specified processing action. The format of the SF directive is: 

SF,FN=filename,UI=userindex,PO=process. 
Parameter Description 



FN=filename The 1 to 7 characters that specify a permanent file or set of permanent 

files. Asterisks in the file name are wild card characters. 

UI=userindex User index of the file specified by the FN=filename parameter. 

PO=process Processing action to be performed on the file specified by the 

FN=filename parameter. 

process Description 

A Archive the specified file. 

B Create a backup copy by destaging the specified file from 

disk to the 7990. 

F Free the specified file from the 7990 by clearing its asa 

value in the file's PFC entry. 

S Stage the specified file from the 7990 to disk. 



For example, the following SF directive selects all permanent files with a maximum of two 
characters in the file name beginning with Z from user index 002622 8 to be staged to disk. 

SF,FN=Z*,UI=2622,PO=S. 

The SF directive can be used without specifying the FN parameter to establish default 
values for the UI and/or PO parameters. These default values will be used for subsequent 
SF, FN=filename directives that are missing UI and/or PO parameters. Default values for 
UI and/or PO parameters can be redefined by using another SF directive without specifying 
the FN parameter. 
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Value Specifier Directives 

SSMOVE uses the value specifier directives to redefine the values of the weight factors or 
thresholds (installation parameters) used in the algorithms that select files to be destaged 
or released. The site analyst uses these value specifiers to increase or decrease the 
importance of certain file characteristics used to determine which files are to be destaged 
and/or released. For example, specifying a large MN parameter prohibits SSMOVE from 
selecting small files for destage/release processing. 

The general format of a value specifier directive statement is: 

directive, qualifier (s) , parameter ( s ) . 



Variable 



Description 



directive 



2-character value specifier directive keyword. 
directive Description 



BR 
FR 
PR 

SM 
WA 
WM 



Keyword for backup requirement directive. 
Keyword for file requirement directive. 
Keyword for preferred residence directive. 
Keyword for site management directive. 
Keyword for weight adder directive. 
Keyword for weight multiplier directive. 



qualifiers) 



One or more qualifier keywords that specify the file type 
(direct/indirect access) and decision type (destage/release) to be used 
in the selection process. If all qualifier keywords are omitted, all 
four combinations of file types and decision types are used in the 
selection process. 



qualifier(s) 



Description 



IA 
DA 
DS 
RL 



Keyword for indirect access files. 
Keyword for direct access files. 
Keyword for destage decisions. 
Keyword for release decisions. 
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Variable 



Description 



parameters) 



Parameter keyword and a value (positive integer) for the specified 
directive keyword. Multiple parameter=value combinations can be 
entered in the same value specifier directive statement. 



parameter(s) 



With BR 
Directive: 

N=wf 



Y=wf 



MD=wf 



WithFR 
Directive: 

MN=min 

MX=max 

DD=dd 

TH=th 



Description 



Weight factor to be used as the backup 
requirement value for decisions involving files 
with a BR=N attribute (no backup). 2 

Weight factor to be used as the backup 
requirement value for decisions involving files 
with a BR=Y attribute (tape backup). 2 

Weight factor to be used as the backup 
requirement value for decisions involving files 
with a BR=MD attribute (media dependent, 
tape, or 7990 backup). 2 



Minimum file size in PRUs. 

Maximum file size in PRUs. 

Number of days since the file was last accessed 

or updated. 

Destage or release threshold. If a file's 
calculated value is less than the specified 
threshold, the file is not a candidate for destage 
or release processing. TH=0 allows all files to 
be candidates for destage and release 
processing unless they are excluded by FR 
directive parameters or by other run-time 
parameter values. 



2. The file owner specifies the backup requirement attribute using the BR parameter on the DEFINE or CHANGE command (refer 
to the NOS Version 2 Reference Set, Volume 3). 
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Variable 



Description 



parameters) (Continued) 

parameter(s) Description 



With PR 
Directive: 

L=wf 



D=wf 



M=wf 



N=wf 



With SM 
Directive: 

MG=mg 



SG=sg 

PI 
P2 



Weight factor to be used as the preferred 
residence value for decisions involving files with 
a PR=L attribute (locked to disk preference). 3 

Weight factor to be used as the preferred 
residence value for decisions involving files 
with a PR=D attribute (disk preference). 3 

Weight factor to be used as the preferred 
residence value for decisions involving files 
with a PR=M attribute (7990 preference). 3 

Weight factor to be used as the preferred 
residence value for decisions involving files 
with a PR=N attribute (no preference). 3 



Master goal specifying the percent of master 
device disk space not to be exceeded. 

Secondary goal specifying the percent of 
secondary device disk space not to be exceeded. 

Available for site use. 
Available for site use. 



3. The file owner specifies the preferred residence attribute using the PR parameter on the DEFINE or CHANGE command (refer 
to the NOS Version 2 Reference Set, Volume 3). 
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Variable 



Description 



parameters) (Continued) 

parameter(s) Description 

With WA 
Directive: 

AG=wa 



LN=wa 

AC=wa 

DV=sf 

WithWM 
Directive: 

AG=wf 

LN=wf 
AC=wf 



Weight adder to be added to the weighted file 

age. 

Weight adder to be added to the weighted file 

length. 

Weight adder to be added to the weighted file 
access count. 

Scaling factor given to the divisor when 
calculating destage and release values. 



Weight factor given to the file age (days since 
the file was last accessed or updated). 

Weight factor given to the file length. 
Weight factor given to the file access count. 



For example, the following value specifier directive specifies that the minimum size for an 
indirect access file to be destaged is three disk PRUs. 

FR,IA,DS,MN=3. 

The following value specifier directive requires that all files to be destaged or released must 
be less than 98765 PRUs long. 

FR,MX=98765. 

If a directive error is detected on the directive input file, SSMOVE ignores the incorrect 
directive and continues to run in report mode. A message is issued to the job dayfile and no 
processing is done. 
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Excluding Destage/Release Processing 

SSMOVE uses FR directives to select candidates for destage and release processing. After 
selecting the candidates and making the final processing decisions, SSMOVE checks the PX 
parameter to determine if any processing should be excluded. 

If FR,RL,MN=9999999 is specified, all files less than 9999999 PRUs will be given a negative 
release value. Any file less than 9999999 PRUs will not be released unless the file has been 
specifically selected for releasing with an SF directive. 

IF PX=A is specified, SSMOVE selects files for processing without considering that release 
processing is prohibited. When the final processing decisions have been made, any files 
selected for releasing will not be processed. That is, files selected for releasing only will not 
be processed; and files selected for both destaging and releasing will not be processed. 

If PX=B is specified, destage processing is excluded just as release processing was in the 
previous description. 

Destaging cannot be excluded with an FR,DS,MN=9999999 directive as releasing can. Even 
though all files less than 9999999 PRUs will be given a negative destage value and not 
selected for destaging, they will be made candidates for destaging in case any of them are 
selected for releasing. When the final processing decisions are made, any file that is a 
candidate for destaging and has been selected for releasing will be destaged and released. 
However, any destaging candidate not selected for releasing will not be destaged. 

Selection Algorithms 

SSMOVE determines which files to destage and/or release according to the following 
algorithms. Files that reside only on 7990 are not considered because they have been 
destaged and released previously. For all other files, SSMOVE checks the file length and 
excludes from further consideration any file whose length in PRUs is less than the 
minimum length threshold (refer back to the MN parameter) or greater than the maximum 
length threshold (refer back to the MX parameter). 

If the current image of the file resides on both disk and 7990, SSMOVE uses the release 
algorithm to determine whether or not to release disk space; the destage algorithm is not 
used. If the current file resides on disk only, SSMOVE uses the destage algorithm to 
determine whether or not to destage the file. If the file is to be destaged to 7990, SSMOVE 
also determines via the release algorithm whether or not to release the file's disk space. 
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Destage and Release Algorithms 

An analyst uses the FR directive to establish file requirements on files that are to be eligible 
for destage and/or release processing. These requirements include file length (minimum and 
maximum) and file age. A file's age is the number of days since the file was last updated 
(for destaging) or accessed (for releasing). Separate requirements can be established for the 
various combinations of file types (direct/indirect) and decision types (destage/release). 

Files that meet the eligibility requirements are assigned separate destage and release 
values. SSMOVE calculates these values for each eligible file according to the following 
equation, which considers various file attributes from the file's PFC entry (length, age, access 
count, preferred residence, and backup requirements). These file attributes are weighted 
according to site-defined values (refer to Value Specifier Directives earlier in this section). 



value = 



(al+a2*length) * (bl+b2*age) * (res) * (bkup) 
(cl+c2*access)*sf 



Variable 



Description 



a i 

a 2 

length 
°l 

b 2 
age 

res 
bkup 



c 2 

access 

sf 



Site-defined length weight adder specified by the WA directive LN 

parameter. 

Site-defined length weight factor specified by the WM directive LN 

parameter. 

Length of the file in PRUs. 

Site-defined age weight adder specified by the WA directive AG 
parameter. 

Site-defined age weight factor specified by the WM directive AG 
parameter. 

Number of days since the file was last updated (for destage) or accessed 
(for release). 

Site-defined preferred residence weight factor specified by the PR 
directive. The PR directive parameter depends on which preferred 
residence attribute the file owner specified. 

Site-defined backup requirement weight factor specified by the BR 
directive. The BR directive parameter depends on which backup 
requirement attribute the file owner specified. 

Site-defined access count weight adder specified by the WA directive 
AC parameter. 

Site-defined access count weight factor specified by the WM directive 
AC parameter. 

Number of times the file was accessed. 

Site-defined scaling factor specified by the WA directive DV parameter. 
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If a file's destage/release value exceeds a site-defined threshold (FR directive TH parameter), 
the file is selected for destage/release processing. Conversely, if the file's destage/release 
value does not exceed the threshold, the file is not considered for destage/release processing. 

Files eligible for releasing are sorted according to their release values. The files on each 
disk with the greatest release values are selected to be released. When enough files have 
been selected and released, the site-defined disk space availability goals will be achieved. 

Decision Algorithm Hierarchy 

Several different functions of SSMOVE can lead to apparent contradictory processing 
decisions. The decisions are made using the following rules, which are listed in order of 
precedence. 

1. SSMOVE does not consider any files for processing if they are excluded by the PX=I, 
PX=D, or UI parameters to SSMOVE or if the file has a PR=L attribute. 

2. Files identified for specific processing using the SF directive are selected for the 
specified processing regardless of the file requirements controlled by the FR directive. 

3. If DN=0, all files that meet the destage requirements are selected to be destaged. 
Otherwise, only files on the specified device are destaged. 

4. No file with a BR=Y attribute will be selected to be released (including files specified for 
processing with an SF directive) if the file data has not been included in a full or 
incremental dump using PFDUMP. 

5. If DN=0, all files that meet the release requirements are selected to be released, if 
needed, to meet the disk space availability goals. Otherwise, only files on the specified 
device are released. 

6. If a file is selected for a specific processing action (such as destage) and the 
corresponding action is precluded by a PX parameter (in this case, PX=B), then the 
selected action is not performed. In all cases, however, the SSMOVE device status 
report is based on which files were selected for processing rather than whether the PX 
parameter actually allowed the selected processing to occur. 
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Disk Space/Dump Tape Management 

As more disk-resident files are created and more 7990-resident files are staged to disk, it 
will be necessary to monitor the availability of disk space. It is recommended that SSMOVE 
be used as a periodic disk space management procedure to avoid frequent disk-full 
conditions (refer to Disk Space Management later in this section). 

SSMOVE can also be used to reduce the amount of data written on dump tapes and thereby 
avoid maintaining large numbers of dump tapes. This is accomplished by destaging to 7990 
and/or releasing disk space of files that need not be on the dump tape (refer to Dump Tape 
Management later in this section). 

An analyst can specify what percent of disk space is to contain indirect access files and what 
percent is to contain direct access files. For direct access files, the analyst can further 
specify the percent of master device and/or secondary device disk space. These percent 
values are applied to all devices in the family on which SSMOVE is run or a specific device 
can be managed by using the DN parameter to SSMOVE. The specified percentages of disk 
space are considered to be goals in that other site-defined constraints and file-busy 
conditions may make it impossible to achieve these goals. 

Restrictions to SSMOVE 

The following restrictions apply to the SSMOVE utility. 

• Only one copy of SSMOVE can be run at a time when it is in the process of destaging 
files. A second SSMOVE aborts if the first one has not completed. 

• SSMOVE and PFDUMP should not be run at the same time. 

• SSMOVE cannot be run when SSVAL is running. 
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Output Example 

The SSMOVE report consists of the following five sections: 

1. A list of directives (figure 11-2) from the input directive file plus any diagnostic 
messages. 

2. A list of run-time parameter values (figure 11-3) used in the release and destage 
decision-making process. These values consist of the site-defined, assembly-time values 
as modified by the value specifier directives. 

3. An optional list of the files (figure 11-4) selected for processing. This list shows the file 
name, file type, user index, length, date, access count, processing action, and destage 
and release values. 

4. A device status report (figure 11-5) that includes a summary of the number of files and 
total file length expected to reside on each device as a result of release processing. Also, 
a subfamily report that includes a summary (for each subfamily) of the number of files 
and file length for files to be destaged, files that reside only on 7990, and files that 
reside on 7990 and disk. 

5. A destage abandonment report (figure 11-6) that is not produced if the NW parameter 
is specified. This report provides a fist of the number of files not destaged and an 
optional list of the abandoned files. It also provides an updated device status report 
reflecting only the files that were destaged. 
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SSMOVE REPORT. 

SSMOVE, I=BIGO,LO+F, FM=MTST. 



yy/iraa/dd. hh.mm.ss. PAGE 



1 FR,MN=0,DD=0. 

2 SM,MG=0,SG=O. 



Figure 11-2. SSMOVE Report: List of Directives 



yy/mm/dd. hh.mm.ss. PAGE 



SSMOVE REPORT. 



RUN-TIKE PARAMETER VALUES 



•DESTAGE* 
DIRECT INDIRECT 



•RELEASE* 
DIRECT INDIRECT 



FILE REQUIREMENTS 



MM 














MX 


9999999 


9999999 


9999999 


9999999 


DD 














TH 


1 


1 


1 


1 



WEIGHT MULTIPLIER 



WM AG 


1 


1 


100 


100 


LN 


1 


1 


1 


1 


AC 


1 


1 


1 


1 


WEIGHT ADDER 










WA AG 


1 


1 


1 


1 


LN 


1 


1 


1000 


1000 


AC 


1 


1 


1 


1 


DV 


1 


1 


1000 


1000 



PREFERRED RESIDENCE 



L 














D 


1 


1 


1 


1 


M 


1 


1 


100 


100 


N 


1 


1 


10 


10 



BACKUP REQUIREMENT 

BR N 1 

Y 1 

MD 5 



SITE MANAGEMENT 

SM MG 

SG 

PI 

P2 



Figure 11-3. SSMOVE Report: Run-time Parameter Values 
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SSMOVE REPORT. 

NAME TYPE UI LENGTH 



yy/mm/dd. hh.mm.ss. PAGE 4 
DATE ACC-CT ACTION!* = NOT DONE PER *PX* OPTION) DES-VAL REL-VAL 



DIR301 


DIR. 


30 


1200 


84 


.09 


.11 





DESTAGE AND RELEASE. 


DIR305 


DIR. 


30 


1200 


84 


.09 


.11 





DESTAGE AND RELEASE. 


DIR302 


DIR. 


30 


1200 


84 


.09 


.11 





DESTAGE AND RELEASE. 


DIR303 


DIR. 


30 


1200 


84 


.09 


.11 





DESTAGE AND RELEASE. 


DIR3 04 


DIR. 


30 


1200 


84 


.09 


.11 





DESTAGE AND RELEASE. 


IND3020 


IND. 


30 


619 


84 


.09 


.11 





DESTAGE AND RELEASE. 


IND3019 


IND. 


30 


618 


84 


.09 


.11 





DESTAGE AND RELEASE. 


IND3018 


IND. 


30 


617 


84 


09 


.11 





DESTAGE AND RELEASE. 


IND3017 


IND. 


30 


616 


84 


09 


.11 





DESTAGE AND RELEASE. 


IND3016 


IND. 


30 


615 


84 


09 


11 





DESTAGE AND RELEASE. 


IND3015 


IND. 


30 


614 


84 


09 


11 





DESTAGE AND RELEASE. 


IND3014 


IND. 


30 


613 


84 


09 


11 





DESTAGE AND RELEASE. 


IND3013 


IND. 


30 


612 


84 


09 


11 





DESTAGE AND RELEASE. 


IND3012 


IND. 


30 


611 


84 


09 


11 





DESTAGE AND RELEASE. 


IND3011 


IND. 


30 


610 


84 


09 


11 





DESTAGE AND RELEASE. 


IND3010 


IND. 


30 


609 


84 


09 


11 





DESTAGE AND RELEASE. 


IND309 


IND. 


30 


608 


84 


09 


11 





DESTAGE AND RELEASE. 


IND308 


IND. 


30 


607 


84 


09 


11 





DESTAGE AND RELEASE. 


IND307 


IND. 


30 


606 


84 


09 


11 





DESTAGE AND RELEASE. 


IND306 


IND. 


30 


605 


84 


09 


11 





DESTAGE AND RELEASE. 


IND305 


IND. 


30 


604 


84 


09 


11 





DESTAGE AND RELEASE. 


IND304 


IND. 


30 


603 


84 


09 


11 





DESTAGE AND RELEASE. 


IND303 


IND. 


30 


602 


84 


09 


11 





DESTAGE AND RELEASE. 


IND302 


IND. 


30 


601 


84 


09 


11 





DESTAGE AND RELEASE. 


IND301 


IND. 


30 


600 


84 


09 


11 





DESTAGE AND RELEASE. 


DIR313 


DIR. 


31 


1200 


84 


09 


11 





DESTAGE AND RELEASE. 


DIR314 


DIR. 


31 


1200 


84 


09 


11 





DESTAGE AND RELEASE. 


DIR312 


DIR. 


31 


1200 


84 


09 


11 





DESTAGE AND RELEASE. 


DIR315 


DIR. 


31 


1200 


84 


09 


11 





DESTAGE AND RELEASE. 


DIR311 


DIR. 


31 


1200 


84 


09 


11 





DESTAGE AND RELEASE. 


IND3120 


IND. 


31 


619 


84 


09 


11 





DESTAGE AND RELEASE. 


IND3119 


IND. 


31 


618 


84 


09 


11 





DESTAGE AND RELEASE. 


IND3118 


IND. 


31 


617 


84. 


09 


11 





DESTAGE AND RELEASE. 


IND3117 


IND. 


31 


616 


84. 


09 


11 





DESTAGE AND RELEASE. 


IND3116 


IND. 


31 


615 


84 


09 


11 





DESTAGE AND RELEASE. 


IND3115 


IND. 


31 


614 


84. 


09 


11 





DESTAGE AND RELEASE. 


IND3114 


IND. 


31 


613 


84. 


09. 


11 





DESTAGE AND RELEASE. 


IND3113 


IND. 


31 


612 


84. 


09. 


11 





DESTAGE AND RELEASE. 


IND3112 


IND. 


31 


611 


84. 


09. 


11 





DESTAGE AND RELEASE. 


IND3111 


IND. 


31 


610 


84. 


09. 


11 





DESTAGE AND RELEASE. 



6005 


22000 


6005 


22000 


6005 


22000 


6005 


22000 


6005 


22000 


3100 


16190 


3095 


16180 


3090 


16170 


3085 


16160 


3080 


16150 


3075 


16140 


3070 


16130 


3065 


16120 


3060 


16110 


3055 


16100 


3050 


16090 


3045 


16080 


3040 


16070 


3035 


16060 


3030 


16050 


3025 


16040 


3020 


16030 


3015 


16020 


3010 


16010 


3005 


16000 


6005 


22000 


6005 


22000 


6005 


22000 


6005 


22000 


6005 


22000 


3100 


16190 


3095 


16180 


3090 


16170 


3085 


16160 


3080 


16150 


3075 


16140 


3070 


16130 


3065 


16120 


3060 


16110 


3055 


16100 



Figure 11-4. SSMOVE Report: Optional List of Files 
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Figure 11-5. SSMOVE Report: Device Status Report 
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Figure 11-6. SSMOVE Report: Destage Abandonment 
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SSVAL 



SSVAL either performs release processing or reports on problems with the current MSE 
system files. When release processing, SSVAL makes 7990 space available that is presently 
allocated to files that are no longer needed, or flags files to be staged to disk in order to free 
up cartridges. When problem reporting, SSVAL reports on irregularities or discrepancies 
found in the current 7990 catalogs and PFC entries for the specified family and, optionally, 
in certain SM maps. The function to be performed is determined by whether or not the RF 
parameter is specified, as described next. 

NOTE 

SSVAL updates the SM map for the specified SM. (Refer to the definition of SM map earlier 
in this section.) It is recommended that the SM map be copied on tape or on another device 
or family immediately after every update of the SM map. 



The format of the SSVAL command is: 

SSVAL, p lf p 2 , . . -,p n . 

Pi Description 



AM 

AM omitted 

FM=familyname 

FM 

FM omitted 

FX=n 

FX 

FX omitted 

L=filename 

L 

L=0 

L omitted 



The SM map for the SM specified by the SM=id parameter is to be 
analyzed in addition to the 7990 catalogs; not valid if RF=filename or 
RF is specified. 

SM maps are not to be analyzed. 

Family to be analyzed; not valid if the RF parameter is specified. 

Same as FM=system default family; not valid if the RF parameter is 
specified. 

Same as FM=system default family if the RF parameter is not 
specified. The family on the release data file is used if the RF 
parameter is specified. 

Error threshold. If the total error count is greater than n, neither 
release processing nor problem fixing is performed. 

Same as FX=0. 

Same as FX=0. 

File on which listable output is to be written. 

Same as L=OUTPUT. 

No output file is to be generated. 

Same as L=OUTPUT. 
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Pi 



Description 



RF=filename 

RF 

RF omitted 

RL 

RL omitted 
SB=subfamily 

SB 

SB omitted 

SM=id 

SM 

SM omitted 

ST=n 

ST 

ST omitted 



File that contains the release data file. 

Same as RF=ZZZZRDF. 

Current versions of the 7990 catalogs are to be analyzed. 

Release processing is to be performed; valid only if the RF parameter is 
specified. 

No release processing is to be performed. 

Subfamily to be processed. Up to eight subfamilies can be selected by 
the numbers through 7. For example, SB=723 selects subfamilies 2, 
3, and 7. 

Same as SB=01234567. 

Same as SB=01234567. 

SM identifier of the SM to be used. Up to 8 SMs can be selected by the 
letters A through H. For example, SM=ACG selects SM A, C, and G. 

Same as SM=ABCDEFGH. 

Same as SM=ABCDEFGH. 

Scattered file criterion. Files are indicated as scattered if they are 
contained on at least n more cartridges than the minimum number 
needed to contain them. 

Same as ST=1. That is, files are scattered if they are contained on 
more than the minimum number of cartridges needed to contain them. 

Same as ST=1. 
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Release Processing 

If RF=filename or RF is specified, SSVAL determines which 7990 files are no longer needed 
and issues a request to SSEXEC to purge these files so their 7990 space can be reused. The 
procedure is for SSVAL to analyze copies of the 7990 catalogs and PFC entries for the 
specified family that are contained on the release data file (RDF) specified by the RF 
parameter. Those 7990 files described in a 7990 catalog but not having a PFC entry (that is, 
orphans) can be purged. During the analysis (refer to both 7990 Catalog Analysis and PFC 
Analysis later in this section), SSVAL keeps track of the error conditions it discovers, and if 
the error count is less than or equal to the threshold specified by the FX parameter, release 
processing is performed if RL is specified. That is, trouble-free orphans are purged and their 
7990 space is made available for reuse. The current 7990 catalog is updated to reflect that 
these files no longer exist. A validation report is issued that lists the errors encountered, 
the number of trouble-free orphans, and the amount of released 7990 space. If RL is not 
specified, no release processing is performed but the validation report is issued, which fists 
the errors encountered, the number of trouble-free orphans, and the amount of releasable 
7990 space. 

The RDF used for this analysis is a file produced during a previous PFDUMP run and it 
contains versions of the 7990 catalogs and PFC entries that were current at the time of the 
dump. The site analyst chooses which RDF to use depending on how long after a file was 
purged he/she wants to wait before releasing 7990 space. For example, the site analyst 
might run SSVAL every week for release processing purposes and use the RDF from the 
previous week's full dump. There are some restrictions as to which RDFs can be used (refer 
to 7990 Space Management later in this section). 

Unlike the purging of disk-only files, where the file space on disk is immediately made 
available for reassignment, the MSE software will not immediately free up a permanent 
file's 7990 space following a purge of the associated disk copy of the permanent file 
(assuming both a 7990 and a disk permanent file image). The reason for not freeing up the 
subject 7990 space is that a subsequent PFLOAD, following a disk failure, could reload the 
PFC entry for the associated permanent file. Therefore, 7990 space for purged permanent 
files that were resident on the 7990 must not be made available for reuse until the 
possibility of such a recovery action cannot occur. 

The site analyst determines which dump tapes can and cannot be used for reloading files 
and PFC entries following a disk failure. When a PFDUMP is taken, two files are normally 
produced: the actual dump file used with PFLOAD to perform a recovery, and the RDF file 
to be used with SSVAL to make 7990 space available after purging files. 

Using an RDF file allows the corresponding dump tape to be used (later dump tapes are 
also allowable), but earlier dump tapes are not allowed. Because the MSE software cannot 
control which dump tapes actually are used in reloading, it is the site analyst's 
responsibility to observe the above restriction. 

The concurrent execution of PFDUMP with OP=S not specified and SSVAL with RL 
specified causes SSVAL to run very slowly. PFDUMP acquires and keeps the PF utility 
interlock for its duration, and this gives the appearance that SSVAL is hung, when it is 
actually just waiting. Therefore, operations personnel should not attempt to run both of 
these utilities with the above options at the same time. 

If the RF parameter is not specified, SSVAL will set the free file flag for all files that totally 
or partially reside on all cartridges on which the free cartridge flag is set. 
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Problem Reporting 

If RF=filename or RF is not specified, SSVAL reports on problems with the current 7990 
catalogs and PFC entries for the specified family. If AM is specified, problems with SM 
maps are also included in the report. SSVAL examines the MSE system files and PFC 
entries and searches for problem chains and fragments, problem asa values, and SM 
map/7990 catalog mismatches. The procedures SSVAL uses to detect and classify 
inconsistencies and discrepancies are described next, under Error Detection and 
Classification. SSVAL keeps track of the error conditions, if any, and if the error count is 
less than or equal to the threshold specified by the FX parameter, problem fixing is 
performed. That is, SSVAL sets flags in the appropriate entries of the SM map, 7990 
catalog, and/or PFC entries to prevent propagation of errors due to the inconsistencies or 
discrepancies found and to permit error recovery by the SSDEBUG utility. A count of the 
errors is recorded in the job dayfile. A validation report is issued, which lists the errors 
encountered, the number of trouble-free orphans, and the amount of releasable 7990 space. 



NOTE 



For release processing or problem fixing, SSVAL predicts what it expects to happen (if no 
problems occur) prior to doing the releasing or fixing. If SSVAL encounters problems, the 
reports may not reflect the actual status of the cartridges. In this case, run SSVAL in 
report mode following the release processing or problem fixing to verify the actual status of 
the 7990 catalogs and cartridges. 



Error Detection and Classification 

SSVAL detects and classifies errors according to the following procedures. During the SM 
map analysis, SSVAL detects and classifies errors in the SM map. During the 7990 catalog 
analysis, SSVAL detects errors with chains of AUs; during the PFC analysis, SSVAL 
classifies these errors. Whenever an error is encountered, the total error count is increased 
by 1. The action taken for each type of error is discussed under Release Processing and 
Problem Fixing later in this section. 

SM Map Analysis 

If the AM option is specified, SSVAL attempts to locate problems with SM map entries by 
comparing the 7990 catalogs and the SM map. For each coordinate pair (y,z) in a 7990 
catalog entry, SSVAL locates the corresponding SM map entry. A type 1 error exists if the 
code field in the SM map entry is not 5 (assigned to a subfamily), or if the family, subfamily, 
or csn fields in the SM map entry do not match those in the corresponding 7990 catalog 
entry. SSVAL also scans the SM map for all other entries assigned to the subfamily and 
reports as a type 2 error any of these entries that does not have a corresponding 7990 
catalog entry. 
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7990 Catalog Analysis 

The 7990 catalog analysis locates problems with chains of AUs (refer to the definition of 
cartridge earlier in this section) and identifies on each HOC whether any of the following 
problems exist or whether any part of the 7990 files resides on a cartridge that is lost or has 
excessive write parity errors. 

SSVAL scans the 7990 catalog for HOC entries that are allocated and follows each chain 
until it terminates. Normal termination occurs with an EOC entry. Abnormal termination 
occurs when no EOC is found, an AU links to an unallocated AU, or an AU links to an AU 
previously found in the chain being followed (looping chain). 

During the chain scans, the following types of chains can be encountered; they are linkage 
problems that are identified on the HOC entry. 

Chain Description ^ 

Intersecting More than one chain links to the same AU. 

Scattered file The number of cartridges used for the file exceeds the value specified 
by the ST parameter. 

SSVAL also locates any AUs that are allocated but were not on any chain being followed. 
Such AUs are linked together to form partial chains without an HOC. These partial chains 
are called fragments and the first AU in a fragment is designated as the start of fragment. 
Each fragment chain is followed until it terminates. The abnormal termination conditions 
previously listed can also occur with fragments. Intersections can occur, but a fragment 
chain that intersects the start of another fragment chain is not an intersection; rather, one 
is the tail end of the other. 
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PFC Analysis 

The PFC analysis is performed to classify the errors encountered on chains during the 7990 
catalog analysis. For each PFC entry with asa*0 (the file has a 7990 image and the asa 
value identifies the first AU in the chain containing the file), SSVAL classifies the following 
errors. Error type 3 exists if the asa value is invalid. Error type 4 exists for any of the 
following reasons: 

• The AU specified by the asa value is not allocated or is not an HOC entry. 

• The chain does not terminate normally. 

• The chain intersects with another chain or fragment. 

• More than one PFC entry points to the chain. 

• The chain includes a cartridge for which the lost or excessive parity error flag is set. 
SSVAL also classifies the following error conditions: 

• Error type 5 exists if an orphan chain terminates abnormally or intersects with other 
chains or fragments. Trouble-free orphans (chains without a PFC entry pointing to 
them and without linkage problems) are not classified as errors. 

• Error type 6 exists if an orphan is a fragment. 

• Error type 7 exists if a chain or fragment points to an unallocated AU. 

SSVAL generates informational report messages if either of the following conditions is true. 

• The system error flag is set in the PFC. 

• The read error flag is set in the PFC. 
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Release Processing and Problem Fixing 

If the total error count calculated during the analyses described previously exceeds the 
value specified by the FX parameter, then neither release processing nor action to flag or fix 
the detected error conditions is performed. The validation report, however, is produced. 
Otherwise, action taken depends on the parameter specified and the type of errors found, as 
follows. 

If SSVAL was run for release processing purposes (RF=filename or RF specified), SSVAL 
issues a request to SSEXEC to release trouble-free orphans if RL was specified. If RL was 
not specified, no release processing is performed. If SSVAL was run for problem reporting 
purposes (RF omitted and FX=n, where n is greater than the number of validation errors), 
the following action is taken. 

• For error type 1, the linkage error flag is set in the 7990 catalog entry. 

• For error type 2, the linkage error flag is set in the SM map entry. 

• For error type 3, there are three alternatives: 

- If the file also has a disk image, the asa field in the PFC entry is cleared. Thus, the 
good disk image will not be released and the file is accessible even if the 7990 
image cannot be retrieved. 

- If the file does not have a disk image, no action is taken. 

- However, if the disk image can be reloaded from tape, it is recommended that the 
file be reloaded using PFLOAD with OP=Z so that the asa field will be cleared. 

• For error type 4, the action taken is both that taken for error type 3 and that taken for 
error type 5, 6, or 7. 

• For error type 5, 6, or 7, the frozen flag is set in the 7990 catalog entry for the initial 
AU on the problem chain or fragment. This enables the problem chain/fragment/AU to 
be made available to the SSDEBUG utility, but prevents these AUs from being 
overwritten until then. Thus, the SSDEBUG utility can be used to inspect or save data 
from the corresponding AUs or cartridges. If the AUs are not allocated, the inhibit flag 
is also set in the 7990 catalog for that cartridge so that no new files will overwrite any 
data that might be on the cartridge. 
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Validation Report 

The validation report consists of a report heading and a series of report groups for each 
subfamily and SM being reported on. The heading identifies the subfamily, the SM, 
whether or not there are any problems, and the last purge date and time for the SM (the 
last time orphans on this SM were released). 

There is one report group for each error detected, and the actual information recorded in a 
report group depends on the type of error, as described next. Each report group, however, 
contains the following items: 

• Error type (a number from 1 to 7). 

• Identification (refer to the particular error type, described next). 

• Chain information (7990 catalog ordinal, AU number, A or U designation for allocated 
or unallocated, H or E designation for HOC or EOC). 

• Error description. 

After the last report group, the validation report lists the number of trouble-free orphans, 
the amount of released or releasable 7990 space, the total number of errors detected, and 
whether or not the MSE system files were updated. 



Error Types 1 and 2 

Error types 1 and 2 identify mismatches between the SM map and the 7990 catalog. In the 
validation report, the identification field lists the 7990 catalog ordinal, the y and z 
coordinates, and the csn of the cartridge in error. The chain field is blank because problem 
chains are not identified as either error type 1 or 2. The analyst should run the SSUSE 
utility to produce a detailed report of the appropriate SM map and 7990 catalog entries to 
determine the exact problem. 



Error Types 3 and 4 

Error types 3 and 4 identify problem chains and problem asa values. In the validation 
report, the identification field lists the permanent file name and user index of the affected 
file; the dump control date and time (from the PFC entry for the file) to identify the backup 
file, if any; and the letter N (no) or Y (yes) to indicate whether or not the file has a disk 
image. The chain field lists the 7990 catalog ordinal and volume number for all AUs in the 
affected chain. An A or U indicates whether each AU is allocated or unallocated, and an H 
or E identifies the HOC or EOC. An error description is printed for each error detected; one 
chain can have several errors. 



Error Types 5, 6, and 7 

Error types 5, 6, and 7 identify problem orphans, fragments, and problem unallocated AUs. 
In the validation report, the information reported is the same as for error types 3 and 4, 
except for the identification field. Instead of the permanent file identification, the word 
ORPHAN (error type 5), FRAGMENT (error type 6), or UNALLOCATED (error type 7) is 
printed. Error type 7 is an unallocated AU that is pointed to by a chain or fragment. Each 
such AU is also reported with the chain for the corresponding orphan or fragment. 
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Intersections 



Intersections occur when more than one chain links to the same AU; they are classified as 
either error type 4 or 5. Thus, they are reported as explained previously. Intersections are 
also reported in a separate entry consisting of a heading and additional information 
identifying the 7990 catalog ordinals and AU numbers of the intersecting chains. Therefore, 
when intersections are reported, there are two entries for the affected subfamily and SM: 
one lists only the intersections and the other lists all the errors encountered. 

Validation Report Example 

Figure 11-7 shows the format of a validation report. SSVAL was run for problem reporting 
purposes (RF not specified), and no errors were detected. 



SSVAL - VALIDATION REPORT 




SSVAL - VER *.* 


FAMILY = MTST 








SSVAL , FM=MTST , SB=0 , SM=A . 






L 


= OUTPUT 






RF 


= 






AM 


= 






SM 


= A 






FM 


= MTST 






FX 


= 






RL 


= 






SB 


= 






ST 


= 






SUBFAMILY =0 SM = A 


-- GOOD — 


LPDT = 


- ******** ******** 


RELEASABLE 7990 FILES 


12 






RELEASABLE 7990 AUS 


= 800 






TOTAL VALIDATION ERRORS 









CATALOGS NOT MODIFIED 








**REPORT COMPLETE** 









Figure 11-7. SSVAL Validation Report 
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Typical SSVAL Runs 

As described previously, SSVAL is run either to make 7990 space available for reuse or to 
report on problems with the current MSE system files and/or PFC entries. The following 
examples show typical SSVAL runs that may be used periodically for these purposes. 

Example 1: 

The following SSVAL command causes 7990 space to be made available for reuse. 

SSVAL , RF=DUMP1 , RL . 

DUMP1 is the release data file produced by a previous PFDUMP run from which SSVAL 
can identify all the 7990 files that were orphans at the time of the dump. If no error 
conditions are detected in the 7990 catalog and PFC entries contained on file DUMP1 (FX=0 
by default), the orphans are purged and the 7990 space assigned to them is released. The 
last purge date and time field in the subcatalog (in the 7990 catalog) for each SM for each 
subfamily is updated to the time of the SSVAL run if any file from that SM is purged. This 
is to ensure that a subsequent SSVAL run does not release the same space a second time, 
as the 7990 space may be reallocated to a new file. 

If errors were detected, they are listed on the validation report and release processing is not 
performed. This is indicated by the CATALOGS NOT MODIFIED message at the end of the 
validation report. The analyst can rerun SSVAL with the following command to ensure that 
release processing is performed (n is the number of errors detected during the previous 
SSVAL run). 

SSVAL , RF=DUMP1 , RL , FX=n . 

After this SSVAL run has completed, an analysis of the current version of the SM map, 
7990 catalog, and PFC entries should be made to determine whether or not the errors 
detected in the first SSVAL run exist in the current MSE system files and PFC entries. 
This is accomplished using the command: 

SSVAL , FM=f amilyname , AM . 

familyname is that on the release data file, DUMP1. 

Example 2: 

Upon completion of any device reload that includes recovery of a 7990 catalog and/or SM 
map, SSVAL should be run to determine whether any SM map/7990 catalog mismatches 
exist. The following call accomplishes this. 

SSVAL, FM=f amilyname, SB=n 1 ,n 2 , - - • ,n h ,AM. 

familyname is that for which recovery was done; n^r^,—^ are tne aSectei subfamilies if 
just some of the devices of the family were reloaded. 
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SSVAL analyzes the SM map, 7990 catalog, and PFC entries for the subfamilies specified by 
the SB parameter and reports any discrepancies or inconsistencies. For example, if the 
recovery was not scheduled and SSLABEL was run to add or remove cartridges or cubicles 
from one of the affected subfamilies after the last incremental or full dump for these 
subfamilies, then the SM map will reflect the results of the SSLABEL run but the 7990 
catalog will not. Such mismatches will be reported on the validation report. 

If the following SSVAL command is then made, the errors detected during the previous run 
will be flagged, as described previously under Release Processing and Problem Fixing. 

SSVAL , FM=f amilyname , SB:;^ , n 2 , . - - , n^, AM, FX=n . 

familyname and ^,112,...,% are the same as in the previous SSVAL run; n is the number of 
errors detected during the previous run. After investigating the cause of these errors, the 
analyst can run the SSDEBUG utility to correct the error conditions (refer to SSDEBUG 
later in this section). 

If a device reload includes recovery of all SM maps (default family, user index=377760 8 ), the 
latest SM maps should be recovered from backup copies. Then each family that has 
7990-resident files should be analyzed using the following command to detect SM map/7990 
catalog mismatches. 

SSVAL , FM= f ami lyname , AM . 

It is recommended that the previous SSVAL run be made periodically to check whether any 
unexpected error conditions exist. As the site analyst becomes more familiar with MSE 
processing, these periodic SSVAL runs can be done less frequently. 

Restrictions to SSVAL 

The following restrictions apply to the SSVAL utility. 

• SSVAL cannot be run when SSMOVE is in the process of destaging files. 

• Only one copy of SSVAL can be run at a time. 

• SSVAL, SSLABEL, and SSDEBUG cannot be run at the same time. 
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SSUSE 

SSUSE reads data in the 7990 catalogs and SM maps and produces reports on the 
availability of space on 7990 cartridges and the allocation of cubicle space within an SM. 
The reports may not be completely up to date because the 7990 catalogs and SM maps can 
be updated while the reports are being generated. 

The types of reports that SSUSE generates are: 



Report 



Description 



Basic usage report 
Optional report A 
Optional report B 

Optional report C 
Optional report D 



Usage report that lists general information about the use of each 
SM in a subfamily. 

SM map report that lists the contents of an SM as described in the 
SM map. 

Cartridge summary report that lists general status information for 
each cartridge entry in the 7990 catalog. The report identifies the 
available AUs and flags set for each cartridge in the 7990 catalog. 

Detailed cartridge report that lists cartridge usage information for 
each cartridge entry in the 7990 catalog. 

Detailed AU status report that lists AU status information for each 
entry in the 7990 catalog plus cartridge usage information. 



Description 



The format of the SSUSE command is: 

SSUSE, p 1 ,p 2 , - ■ • ,P n - 
_Pi 

CM=A- 

CM 

CM omitted 

CN=csn 



CN 

CN omitted 

FM=familyname 

FM 

FM omitted 

L=filename 

L 



Cartridge manufacturer code is A-, indicating IBM. 

Same as CM=A- 

Same as CM=A-. 

Cartridge serial number of a specific cartridge. The CN=csn parameter 
is valid only if the OP=D parameter is specified. 

Cartridge serial number is not specified. 

Same as CN. 

Family to be reported on. 

Same as FM=system default family. 

Same as FM=system default family. 

File on which listable output is to be written. 

Same as L=OUTPUT. 
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Report 



Description 



L=0 

L omitted 

OP=op 



OP 

OP omitted 

SB=subfamily 

SB 

SB omitted 

SM=id 

SM 

SM omitted 



No output file is to be generated. 

Same as L=OUTPUT. 

Type of report to be generated. Multiple options can be specified (for 
example, OP=AB). 



2EL 



Description 



A 
B 
C 
D 



Optional report A and basic usage report. 
Optional report B and basic usage report. 
Optional report C and basic usage report. 
Optional report D and basic usage report. 



Basic usage report only is to be generated. 

Same as OP. 

Subfamily to be reported on. Up to eight subfamilies can be selected 
by the numbers through 7. For example, SB=0273 selects 
subfamilies 0, 2, 3, and 7. 

Same as SB=01234567. 

Same as SB=01234567. 

SM identifier of the SM to be used. Up to eight SMs can be selected 
by the letters A through H. For example, SM=AGC selects SM A, C, 
andG. 

Same as SM=A. 

Same as SM=A. 



Basic Usage Report 

The basic usage report includes a title line, which identifies the family and SM being 
reported on. The statistics in this report contain data for each group followed by totals for 
SMs and subfamilies. The following items are listed. 

• Number of cubicles reserved for each subfamily. 

• Number of cartridges in each subfamily. 

• Number of unassigned and unflagged AUs for small files. 

• Number of unassigned and unflagged AUs for large files. 

• Number of flagged cartridges. 

• Number of flagged AUs. 

• If any empty cubicles are assigned, they are listed first for each subfamily. This line 
shows a hyphen (-) as the group designator since groups are assigned only to cartridges. 

Figure 11-8 shows the format of a basic usage report. 
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SSUSE REPORT FILE 

SSUSE BASIC REPORT 



CUBE = CUBICLES 
CART = CARTRIDGES 



** = SUBFAMILY TOTAL 
- = UNASSIGNED GROUP 



yy/mm/dd. hli.mm.ss. PAGE 

FAMILY = MTST 

CARTRIDGE FLAGS 
M = MISSING 
I = INHIBIT ALLOCATION 
F = FREE CARTRIDGE 

L = OFF CARTRIDGE LINKS AVAILABLE 
P = EXCESSIVE PARITY ERRORS 
E = MAP ERROR(AS DETECTED BY SSVAL) 



AVAILABLE NUMBER CARTRIDGES FLAGGED 

SUB SM GR CUBE CART AU AU M I F L P E 
(SMALL) (LARGE) 



AU FLAGS 
FA = FLAWED AND ALLOCATED 
FU = FLAWED AND UNALLOCATED 
SF = START OF FRAGMENT 
FC = FROZEN CHAIN 
AC = AU CONFLICT 



— NUMBER AU FLAGGED- - 
FA FU SF FC AC 



A 


_ 


2 












































A 


1 


2 


2 


1167 


2662 











2 























A 


** 


4 


2 


1167 


2662 











2 























1 A 




3 












































1 A 


1 


2 


2 


1168 


2 662 











2 























1 A 


** 


5 


2 


1168 


2662 











2 























2 A 




3 












































2 A 


1 


2 


2 


1168 


2606 











2 























2 A 


** 


5 


2 


1168 


2606 











2 























3 A 


. 


3 












































3 A 


1 


2 


2 


1168 


2586 











2 























3 A 


*. 


5 


2 


1168 


2586 











2 























4 A 




3 












































4 A 


1 


2 


2 


1168 


2662 











2 























4 A 


** 


5 


2 


1168 


2662 











2 























5 A 


. 


3 












































5 A 


1 


2 


2 


1168 


2662 











2 























5 A 


** 


5 


2 


1168 


2662 











2 























6 A 


. 


2 












































6 A 


1 


3 


3 


5400 


7 





2 





1 

















3 





6 A 


* * 


5 


3 


5400 


7 





2 





1 

















3 





7 A 




3 












































7 A 


1 


2 


2 


1200 


2662 











2 























7 A 


«* 


5 


2 


1200 


2662 











2 
























Figure 11-8. SSUSE Basic Report (Continued) 
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SSUSE REPORT FILE 

SSUSE BASIC REPORT 


yy/inm/dd. 
SM AND SUBFAMILY TOTALS 


hh.mm.ss. PAGE 

FAMILY = MTST 


2 








SUB SM GR 


CUBE 


CART 


AVAILABLE 

AU AU 
(SMALL) (LARGE) 


NUMBER CARTRIDGES 
M I F L 


FLAGGED 
P E 


FA 


NUMBER 
FU 


AU 
SF 


FLAGGED- - 
FC AC 


SM TOTALS 


FOR SPECIFIED 


SUBFAMILIES 






















** A ** 


39 


17 


13607 


18509 





2 





15 

















3 


SUBFAMILY 


TOTALS 


FOR SPECIFIED 


SM-S 






















Q ** ** 


4 


2 


1167 


2662 











2 




















j_ ** ** 


5 


2 


1168 


2662 








□ 


2 




















2 ** ** 


5 


2 


1168 


2606 











2 




















2 ** ** 


5 


2 


1168 


2586 











2 




















4 ** ** 


5 


2 


1168 


2662 











2 




















5 ** ** 


5 


2 


1168 


2662 











2 




















g ** ** 


5 


3 


5400 


7 





2 





1 

















3 


•7 ** ** 


5 


2 


1200 


2662 











2 





















Figure 11-8. SSUSE Basic Report 



Optional Report A 

Optional report A includes a title line that identifies the SM being reported on. This report 
is made up of 15 pages, each page describing the SM map for specific y and z coordinates. 
Each page describes 22 y coordinates (rows) and 1 z coordinate (column). Column 6 (z=6) is 
not reported on because it contains the data recording drives. The information listed in 
optional report A includes the following items: 

y and z coordinates. 

Cartridge manufacturer code and CSN of the cartridge. 

Family and subfamily. 

Group and ordinal in group. 

Flags. 

Figure 11-9 shows the format of optional report A. 
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yy/mm/dd. hh.mm.ss. PAGE 

SSUSE REPORT FILE 

SSUSE OPTIONAL REPORT A - STORAGE MODULE MAP FOR SM = A 



FLAGS: 



P = CARTRIDGE EXISTS IN POOL 

F = NOT ASSIGNED TO THIS FAMILY 

R = RESERVED FOR ALTERNATE SMMAP 

S = RESERVED FOR SYSTEM USE 

E = ERROR FLAG 

C = RESERVED FOR CUSTOMER ENGINEERING 

N = (Y,Z) DOES NOT EXIST. IN SMMAP 



GPORD = ORDINAL IN GROUP 



Y 


Z 


CM 


CSN 


FAMII 














1 











2 











3 











4 











5 











6 











7 











8 











9 











10 











11 











12 











13 











14 











15 











16 











17 









MTST 


18 









MTST 


19 





A- 


51680502 


MTST 


20 





A- 


13727600 


MTST 


21 












SUBFAMILY 



GROUP GPORD 



FLAGS 

C F 
F 

F 

F 

F 

F 

F 

F 

F 

F 

F 

NF 

NF 

NF 

NF 

NF 

F 



S F 



Figure 11-9. SSUSE Optional Report A 
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Optional Report B 

Optional report B includes a title line identifying the subfamily, family, and SM being 
reported on. There is one line of output per cartridge within a subfamily and storage module. 
The report includes the following cartridge information about entries in the 7990 catalog. 

Group and ordinal in group. 

y and z coordinates. 

Cartridge manufacturer code and CSN of the cartridge. 

Free AUs for small and large files. 

Cartridge flags. 

Error conditions. 

Figure 11-10 shows the format of optional report B. 







yy/mm/dd. 


hh.mm.ss. PAGE 


25 




SSUSE REPORT 


FILE 












SSUSE OPTIONAL REPORT B - CARTRIDGE SUMMARY REPORT SM = A 


SUBFAMILY = 6 


FAMILY = MTST 


NOTES : 






CARTRIDGE FLAGS: 






FA = FLAWED AND ALLOCATED 




M 


= MISSING 






FU = FLAWED AND UNALLOCATED 




I 


= INHIBIT 






SF = START OF FRAGMENT 




F 


= FREE CARTRIDGE 






FC = FROZEN CHAIN 




L 


= LINKIFREE AU EXIST, NO OFF CARTRIDGE LINK) 


AC = AU 


CONFLICT 




P 


= EXCESSIVE WRITE 


ERRORS 




GPORD = 


ORDINAL IN GROUP 




E 


= MAP ERROR (DETECTED BY SSVAL) 

ERROR CONDITIONS- 










FREE 


AU 


CART 










GP GPORD 


Y Z CM CSN 


SMALL 


LARGE 


FLAGS FA 


FU SF FC 


AC 


1 


21 7 A-13268794 


1800 





I L 


3 





1 1 


20 7 A-51329412 


1800 


3 


I 








1 2 


19 7 A-51328839 


1800 


4 


L 









Figure 11-10. SSUSE Optional Report B 
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Optional Report C 

Optional report C is the detailed cartridge report. It lists the group and FCT ordinal for 
each 7990 catalog entry and the y and z coordinates and CSN for each cartridge. The report 
also includes the AU numbers of the first AUs for small and large files and the division 
point for each cartridge. 

Figure 11-11 shows the format of optional report C. 



yy/mm/dd. hh.mm.dd. PAGE 33 
SSUSE REPORT FILE 

SSOSE OPTIONAL REPORT C - DETAILED CARTRIDGE REPORT SM = A SUBFAMILY = 6 FAMILY = MTST 

FLAGS: I = INHIBIT ALLOCATION M = MISSING P = EXCESSIVE PARITY ERRORS 

E = MAP ERROR OCL = AVAILABLE LINK COUNT FCTORD = SFM CATALOG ORDINAL 



CARTRIDGE 



Y 


Z 


CM CSN 


GRO 


21 


7 


A-13268794 


1 


20 


7 


A-51329412 


1 


19 


7 


A-51328839 


1 



FLAGS 



16 I 

17 I 
18 



FIRST 


FIRST 


DIVISION 


OC 


SMALL 


LARGE 


POINT 




1 





1801 





1 


1916 


1801 


2 


1 


1832 


1801 






Figure 11-11. SSUSE Optional Report C 
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Optional Report D 

Optional report D is the detailed AU status report. It lists the group and FCT ordinal of the 
cartridge, the CSN, the y and z coordinates of the cartridge, and the number of available 
off-cartridge links. The report also includes the octal numbers of the AUs with flawed AU, 
start of volume, and error flags noted. This report also specifically notes when a cartridge is 
empty (for use in determining the status of a cartridge that is to be made available). 

Figure 11-12 shows the format of optional report D. 









yy/mm/dd. hh.iran 


ss . PAGE 


6 






SSUSE 


REPORT FILE 














SSUSE 


OPTIONAL REPORT D - DETAILED AU STATUS REPORT 


SM = A SUBFAMILY = 1 


FAMILY = MTST 


F 


= FLAWED AU (DEMARK FAILURE) 












V 


= START OF 


VOLUME 














E 


= ONE OF THE ERROR FLAGS 


SET (AU CONFLICT, FROZEN CHAIN, START OF FRAGMENT) 




FCTORD Y 


Z CM CSN GROUP 










16 


21 


1 A-51328833 


1 










AU 


XXXO 


XXXI 


XXX2 


XXX3 


XXX4 


XXX5 


XXX6 


XXX7 


100X 


0041300731 


0041270731 


0041260731 


0041250731 


0041240731 


0041230731 


0041220731 


0041210731 


101X 


0041200731 


0041170731 


0041160731 


0041150731 


0041140731 


0041130731 


0041120731 


0041110731 


102X 


0041100731 


0041070731 


0041060731 


0041050731 


0041040731 


0041030731 


0041020731 


0041010731 


103X 


0041000731 


0040770731 


0040760731 


0040750731 


0040740731 


0040730731 


0040720731 


0040710731 


104X 


0040700731 


0040670731 


0040660731 


0040650731 


0040640731 


0040630731 


0040620731 


0040610731 


105X 


0040600731 


0040570731 


0040560731 


0040550731 


0040540731 


0040530731 


0040520731 


0040510731 


106X 


0040500731 


0040470731 


0040460731 


0040450731 


0040440731 


0040430731 


0040420731 


0040410731 


107X 


0040400731 


0040370731 


0040360731 


0040350731 


0040340731 


0040330731 


0040320731 


0040310731 


110X 


0040300731 


0040270731 


0040260731 


0040250731 


0040240731 


0040230731 


0040220731 


0040210731 


111X 


0040200731 


0040170731 


0040160731 


0040150731 


0040140731 


0040130731 


0040120731 


0040110731 


112X 


0040100731 


0040070731 


0040060731 


0040050731 


0040040731 


0040030731 


0040020731 


0040010731 


113X 


0040000731 


V0000621214 


0040611131 


0040601131 


0040571131 


0040561131 


0040551131 


0040541131 


114X 


0040531131 


0040521131 


0040511131 


0040501131 


0040471131 


0040461131 


0040451131 


0040441131 


115X 


0040431131 


0040421131 


0040411131 


0040401131 


0040371131 


0040361131 


0040351131 


0040341131 


116X 


0040331131 


0040321131 


0040311131 


0040301131 


0040271131 


0040261131 


0040251131 


0040241131 


117X 


0040231131 


0040221131 


0040211131 


0040201131 


0040171131 


0040161131 


0040151131 


0040141131 


12 OX 


0040131131 


0040121131 


0040111131 


0040101131 


0040071131 


0040061131 


0040051131 


0040041131 


12 IX 


0040031131 


0040021131 


0040011131 


0040001131 


V0001771414 


0041761214 


0041751214 


0041741214 


122X 


0041731214 


0041721214 


0041711214 


0041701214 


0041671214 


0041661214 


0041651214 


0041641214 


123X 


0041631214 


0041621214 


0041611214 


0041601214 


0041571214 


0041561214 


0041551214 


0041541214 


124X 


0041531214 


0041521214 


0041511214 


0041501214 


0041471214 


0041461214 


0041451214 


0041441214 


125X 


0041431214 


0041421214 


0041411214 


0041401214 


0041371214 


0041361214 


0041351214 


0041341214 


126X 


0041331214 


0041321214 


0041311214 


0041301214 


0041271214 


0041261214 


0041251214 


0041241214 


12 7X 


0041231214 


0041221214 


0041211214 


0041201214 


0041171214 


0041161214 


0041151214 


0041141214 


130X 


0041131214 


0041121214 


0041111214 


0041101214 


0041071214 


0041061214 


0041051214 


0041041214 


13 IX 


0041031214 


0041021214 


0041011214 


0041001214 


0040771214 


0040761214 


0040751214 


0040741214 


132X 


0040731214 


0040721214 


0040711214 


0040701214 


0040671214 


0040661214 


0040651214 


0040641214 


133X 


0040631214 


0040621214 


0040611214 


0040601214 


0040571214 


0040561214 


0040551214 


0040541214 


134X 


0040531214 


0040521214 


0040511214 


0040501214 


0040471214 


0040461214 


0040451214 


0040441214 


13 5X 


0040431214 


0040421214 


0040411214 


0040401214 


0040371214 


0040361214 


0040351214 


0040341214 


13 6X 


0040331214 


0040321214 


0040311214 


0040301214 


0040271214 


0040261214 


0040251214 


0040241214 


137X 


0040231214 


0040221214 


0040211214 


0040201214 


0040171214 


0040161214 


0040151214 


0040141214 



Figure 11-12. SSUSE Optional Report D 
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SSDEBUG 

SSDEBUG allows the analyst to update appropriate entries in the SM maps and/or 7990 
catalogs and thereby resolve inconsistencies reported by the SSVAL utility. SSDEBUG can 
also copy data from selected 7990 files or cartridges to disk. This function of SSDEBUG is 
intended for use when errors such as unrecoverable read errors do not allow successful 
staging of a 7990 file. 



NOTE 



SSDEBUG updates the SM map for the specified SM. (Refer to the definition of SM map 
earlier in this section.) It is recommended that the SM map is copied on tape or on another 
device or family immediately after every update of the SM map. 



Input to SSDEBUG is via a directive file. Refer to SSLABEL, earlier in this section, for a 
description of the directive file format. 

The format of the SSDEBUG command is: 

SSDEBUG , P2 , p 2 , P3 • 

Pj Description 

I=filename 

I 

I omitted 

L=filename 

L 

L=0 

L omitted 

Z 



Z omitted 



File on which directives are written. 

Same as I=INPUT. 

Same as I=INPUT. 

File on which listable output is to be written. 

Same as L=OUTPUT. 

No output file is to be generated. 

Same as L=OUTPUT. 

Directives are contained on the SSDEBUG command. The I parameter 

is ignored. 

Directives are contained on the file specified by the I parameter. 
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SSDEBUG Directives 



The following directives are available with SSDEBUG. The descriptions of the parameters 
for these directives follow this listing of directives. 

OP=RS — Read AUs 

OP=RS reads selected AUs of a cartridge identified by its csn (CN=csn) or y and z 
coordinates (YI and ZI parameters). The SM parameter specifies the SM where the 
cartridge resides. The range of AUs to be read is specified by the SL and SU parameters. 
The AUs are written to the file specified by the PF parameter. All CYBER data plus 7990 
and CRC data, including header and trailer information, is returned. The analyst can write 
an application program to reconstruct the permanent file by stripping off all CYBER or 
7990 related control information. Refer to Format of Disk Files Read From 7990 by 
SSDEBUG later in this section for a description of the control information written to disk 
along with the disk file contents. 

OP=RF — Read File 

OP=RF reads the file whose alternate storage address is specified by the FO, SB, SM, and 
ST parameters. The file is written to the file specified by the PF parameter. All data, 
including header and trailer information, is returned (refer to Format of Disk Files Read 
From 7990 by SSDEBUG later in this section). 

OP=RP — Release Frozen Chain Space 

OP=RP clears flags in the 7990 catalog and releases 7990 space for the chain whose 
alternate storage address is specified by the FO, SB, SM, and ST parameters. 

OP=RL — Remove Cartridge Entry From 7990 Catalog 

OP=RL removes a 7990 catalog entry that is not linked properly to the SM map. The FO, 
SB, and SM parameters identify the 7990 catalog entry to be removed. 

OP=RC — Remove Cartridge Entry From SM Map 

OP=RC removes an SM map entry that does not have a corresponding FCT entry in the 
7990 catalog. The SM, YI, and ZI parameters identify the SM map entry to be removed. 
The cartridge at the particular location (y,z) is put into the exit tray and the SM map entry 
is changed to unassigned. The SM map should be backed up immediately after the 
SSDEBUG run to ensure consistency with cartridge labels and 7990 catalogs (refer to the 
definition of SM map earlier in this section). 

A scratch label is written on the cartridge prior to it being replaced in the exit tray, but the 
cartridge history information remains intact. 

OP=CF — Change Flag in SM Map or 7990 Catalog 

OP=CF sets or clears flags in the SM map or 7990 catalog. The FL and ON or OF 
parameters indicate the flag type and the action to be taken. The appropriate FCT entry or 
SM map entry is determined from the CN, FO, or YI and ZI parameters. For FCT flags 
(FL=AC, FC, or SF), the analyst can specify either a single AU using the ST parameter or a 
range of AUs using the SL and SU parameters. 
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Parameters for the SSDEBUG Directives 

The descriptions of the parameters to the SSDEBUG directives follow. Not all parameters 
are valid with all directives, as indicated. 



Pi 



CM=A- 

CM 

CM omitted 

CN=csn 

CN omitted 
FL=flag 



Description 



Cartridge manufacturer code is A-; indicating IBM. 

Same as CM=A-. 

Same as CM=A-. 

Cartridge serial number of the cartridge to be used; not valid for 
OP=RS if YI=y or ZI=z is specified; and not valid for OP=CF if FO=ord, 
YI=y, or ZI=z is specified. 

YI=y and ZI=z must be specified for OP=RS. FO=ord or YI=y and ZI=z 
must be specified for OP=CF. 

Name of flag in SM map or 7990 catalog to be set or cleared. Valid only 
for OP=CF. 



flag 



Description 



AC AU conflict flag. 

EW Excessive write parity error flag. 

FC Frozen chain flag. 

FE Linkage error flag (in 7990 catalog FCT). 

IB Inhibit allocation flag. 

LC Lost cartridge flag. 

ME Linkage error flag (in SM map). 

SF Start of fragment flag. 

FL omitted FL=flag must be specified for OP=CF. 

FM=familyname Family to be processed. 

FM Same as FM=system default family. 

FM omitted Same as FM=system default family. 
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Pi 



Description 



FO=ord 

FO omitted 

OF 
ON 

PF=filename 

PF 

PF omitted 

SB=subfamily 

SB 

SB omitted 

SL=i 

SL 

SL omitted 

SM=id 

SM 

SM omitted 

ST=s 



7990 catalog ordinal indicating the file to be read or the chain whose 
space is to be released. Not valid for OP=CF if CN=csn, YI=y, or ZI=z 
is specified. 

FO=ord must be specified for OP=RF, OP=RP, and OP=RL. CN=csn or 
YI=y and ZI=z must be specified for OP=CF. 

Flag specified by FL=flag is to be cleared. Valid only with OP=CF. 

Flag specified by FL=flag is to be set. Valid only with OP=CF. 

File to which the 7990 image is to be copied. This file is defined under 
the user's current family and user index. 

Same as PF=MMMMBUG. 

Same as PF=MMMMBUG. 

Subfamily to be used; < subfamily < 7. 

Same as SB=0. 

Same as SB=0. 

AU where OP=RS begins copying or OP=CF begins changing flags; 1 < i 
< 1931; i < j (refer to SU=j). 

Same as SL=1. 

Same as SL=1. 

SM identifier of the SM to be used by SSDEBUG; id is a letter from A 
toH. 

Same as SM=A. 

Same as SM=A. 

AU where OP=RF begins reading files or fragments or OP=RP begins 
releasing frozen chain space. If specified with OP=CF, ST=s specifies 
the AU number of an FCT flag to be changed and takes precedence 
over the range of AUs specified by the SL and SU parameters. AU 
numbers are meaningful with OP=CF only for flags FL=AC, FC, or SF. 
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Pi 



Description 



ST omitted ST=s must be specified for OP=RF and OP=RP. 

SU=j AU where OP=RS ends copying or OP=CF ends changing flags; 

1 < j < 1931; i < j (refer to SL=i). 

SU Same as SU=1. 

SU omitted Same as SU=1. 

YI=y y coordinate of the cubicle where the cartridge to be read resides; 

< y < 21. ZI=z must also be specified. CN=csn must not be specified 
with OP=RS. FO=ord or CN=csn must not be specified with OP=CF. 

YI omitted CN=csn must be specified for OP=RS. FO=ord or CN=csn must be 

specified for OP=CF. YI=y and ZI=z must be specified for OP=RC. 

ZI=z z coordinate of the cubicle where the cartridge to be read resides; 

< z < 15 and 7#&. YI=y must also be specified. CN=csn must not be 
specified with OP=RS. FO=ord or CN=csn must not be specified with 
OP=CF. 

ZI omitted CN=csn must be specified for OP=RS. FO=ord or CN=csn must be 

specified for OP=CF. YI=y and ZI=z must be specified for OP=RC. 
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Using SSDEBUG 



Suppose the following validation report (figure 11-13) was generated by running SSVAL for 
problem reporting purposes. 



SUBFAMILY =4 SM = 


A 


PROBLEMS 


LPD1 


= yy/mm/dd. hh.mm.ss 


ERR IDENTIFICATION 


-CHAIN- 


ERROR DESCRIPTION 


TYP 




FCT - AU 


- A/U - 


H/E 


5 ORPHAN 




017-1737 

017-1738 
017-1739 
017-1740 
017-1741 
017-1742 
017-1743 
017-1930 
017-1931 


AH- 

A— 
A — 
A— 
A — 
A— • 
A— 
A — 
A — 


ILL-FORMED CHAIN 
SCATTERED FILE (INFO) 






019-0000 


U-- 


START OF FRAGMENT 


7 UNALLOCATED 




019-0000 


U-- 


START OF FRAGMENT 



Figure 11-13. SSDEBUG: Executing SSVAL in Problem-Fixing Mode 

This partial validation report shows an error type 5 identified by ORPHAN with an error 
description of ILL-FORMED CHAIN (frozen chain). You can use SSDEBUG to set (OP=CF) 
and release (OP=RP) the frozen chain space or you can execute SSVAL in problem-fixing 
mode to set the frozen chain flag. 

Enter the following SSDEBUG command to set the frozen chain flag for the range of AUs 
specified by the SL and SU parameters. 

SSDEBUG, Z . /OP=CF , FL=FC , ON, FM=SMD, SB=4 , SL=1737 , SU=1931 , F0=17 , ST=1737 . 

When the SSDEBUG or SSVAL command is processed, enter the following command to 
release the frozen chain space. 

SSDEBUG, Z . /OP=RP, SB=4 , SM=A, ST=1737 , FO=17 , FM=SMD . 

When this command is processed, you can verify that the frozen chain has been set by 
running SSVAL again to generate another validation report. 
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Restrictions to SSDEBUG 

The following restrictions apply to the SSDEBUG utility. 

• SSEXEC must be running when SSDEBUG is run. 

• Only one copy of SSDEBUG can be run at one time. 

• SSDEBUG, SSVAL, and SSLABEL cannot be run at the same time. 

y,z Relationship with SM Map Ordinal 

A one-to-one functional mapping exists between coordinate pairs and the ordinal entries 
within the SM map. To determine the coordinate pair (y,z) from the SM map ordinal (ord), 
use the following equations: 

y = (352-ord)/16 
z = 352-ord-16y 

To determine the SM map ordinal (ord) from the coordinate pair (y,z), use the following 
equation: 

ord=352-z-16y 
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Format of Disk Files Read From 7990 by SSDEBUG 

A local disk file created by SSDEBUG with the OP=ES or OP=RF option includes all 
CYBER and 7990 header and trailer information. Figure 11-14 shows the format of a disk 
file created when SSDEBUG reads a full stripe; figure 11-15 shows the format of a disk file 
created when SSDEBUG reads a partial stripe. 



WORD 



% 



CYBER DATA (§) 



1601, 



7990 READ RAW DATA MESSAGE (64 BYTES) 
(PACKED 6 BYTES PER 60-BET WORO, LEFT-JUSTIFIED. 
2ERO-FILLED) 



7990 STR IPE HEADER (32 BYTES! © ® 



7980 BLOCK HEADER LABEL (16 BYTES) 
(PACKED 7.5 BYTES PER WORD WITH 1 BYTE LEFT- 
JUSTIFIED IN THIRD WORDS 



CYBER HEADER LABEL (150 BYTES) © 



13 PRU* OF CYBER DATA (6279 BYTES) © 
(483 BYTES PER PRU) 



CYBER TRAILER LABEL (90 BYTES) © 



7990 BLOCK TRAILER LABEL (16 BYTES) 

(SAME FORMAT AS 7990 BLOCK HEADER LABEL) 



UNUSED BYTES (11 BYTES) © 
(TO FILL STRIPE) 



7990 STRIPE TRAILER (32 BYTES) © 



S BYTES ARE 8-BIT ASCII BYTES PACKED 75 BYTES PER 60-BIT WORD IN A CONTINUOUS BIT STREAM. 
FOR FULL STRIPES, THE BLOCK TYPE IN THE 7990 BLOCK HEADER IS 01. 

(D FOR CYBER DATA, EVERY 2S5TH BYTE IS A CRC BYTE. THE LAST BYTE IS ALWAYS A CRC BYTE TO 
TAKE CARE OF SHORT DATA BLOCKS. FULL CYBER DATA BLOCKS HAVE 26 CRC BYTES. 



Figure 11-14. Full Stripe Disk File Format 
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7990 READ RAW DATA MESSAGE (64 BYTES) 
(PACKED 6 BYTES PER 60-BIT WORD, LEFT-JUSTIFIED. 
ZERO-FILLED) 



7990 STRIPE HEADER (32 BYTES) 



7990 BLOCK HEAOER LABEL (16 BYTES) ® 
(PACKED 7.5 BYTES PER WORD WITH 1 BYTE LEFT- 
JUSTIFIED IN THIRD WORD) 



CYBER HEADER LABEL (150 BYTES) 



oPRUs OF CYBER DATA <n< 13) 
(483 BYTES PER PRU) 



7990 BLOCK TRAILER LABEL (16 BYTES) 
(SAME FORMAT AS 7990 BLOCK HEADER LABEL) 



7990 BLOCK HEADER LABEL (16 BYTES) ® 



7990 BLOCK TRAILER LABEL (16 BYTES! 



UNUSED BYTES 



7990 STRIPE TRAILER (32 BYTES) 



TAPE MARK ® 



BYTES ARE 8-BIT ASCII BYTES PACKED 75 BYTES PER 80-BIT WORD IN A CONTINUOUS BIT STREAM. 
® FOR PARTIAL STRIPES, THE BLOCK TYPE IN THE 7990 BLOCK HEADER IS 01 FOR DATA BLOCKS AND 

10,« FOR TAPE MARK BLOCKS. 
® FOR CY8ER DATA, EVERY 255TH BYTE IS A CRC BYTE. THE LAST BYTE IS ALWAYS A CRC BYTE TO 
^ TAKE CARE OF SHORT DATA BLOCKS. 
® A TAPE MARK HAS A 7990 BLOCK HEADER AND TRAILER. BUT NO DATA BLOCK. 



Figure 11-15. Partial Stripe Disk File Format 
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7990 Stripe Header and Trailer 

The 7990 stripe header is a 32-byte block that occupies the first 32 bytes of the stripe; the 
7990 stripe trailer occupies the last 32 bytes. The 7990 stripe header and trailer have the 
same format. 

Bytes Description 

0-5 Volume serial number. A 6-character string specifying the volume 

serial number of the stripe. 

6-7 Version number. Two characters specifying the version number 

associated with the volume serial number. 

8-9 File number. Two characters specifying the number of the file within 

the volume. 

A-B Logical stripe number. Relative stripe number within the volume. The 

logical stripe number may not correlate with the physical stripe 
number due to demarked stripes. 

C-D Address of last block trailer. Byte number, within the stripe, of the 

first byte of the last block trailer. 

E-1D Reserved. 

1E-1F Checksum. Chosen such that the sum, modulo 65536, of all bytes in 

the header equals zero. 
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7990 Block Header and Trailer 

Each 7990 block has a 16-byte header that precedes each block and a 16-byte trailer that 
follows each block, or partial block, of data on the stripe. The 7990 block header and trailer 
have the same format. 

Byte(s) Description _^ 



0-1 Block type. The following block types are valid. 

Block 

Type Description 



01 A complete block is contained in this stripe. 

02 First block segment of a multistripe block. 

04 Intermediate block segment of a multistripe block. 

08 Last block segment of a multistripe block. 

10 16 Tape mark. 

2-3 Block length. The number of bytes in a data block excluding the block 

header and trailer. The block length of a tape mark is zero. 

4_7 Block sequence number. The number of a given data block within a file. 

8-9 Block segment number. For complete blocks, the segment number is 

(zero). For multistripe blocks, the segment number is the sequence 
number of the block segment within the data block. 

A-E Reserved. 

F Checksum. Chosen such that the sum, modulo 256, of all bytes in the 

header equals zero. 
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SSBLD 

SSBLD reads a specified direct access permanent file that contains SSBLD statements. 
These statements consist of 7990 component-oriented mnemonics that define the logical 
mapping from component to component within the 7990 configuration. SSBLD processes 
these statements and generates a direct access permanent file which SSEXEC uses as its 
unit device table (UDT). 

The format of the SSBLD command is: 

SSBLD, CF=conf ile , BF=bldf ile . 

Parameter Description 

CF=confile Configuration file on which SSBLD statements are written under user 

index 377760 8 . 

CF Same as CF=SUDT. 

CF omitted Same as CF=SUDT. 

BF=bldfile Build file on which SSBLD generates the UDT for SSEXEC. The build 

file is under user index 377760 8 . 

BF Same as BF=BUDT. 

BF omitted Same as BF=BUDT. 



SSBLD Statements 

The 7990 hardware consists of a number of 7990 control units (CU) and a number of 7991 
storage modules (SM). SSBLD uses two types of statements: those that link individually 
controllable nodes and paths within each CU, and those that link SMs to CUs. SSBLD 
statements must be processed in the following sequence or SSBLD aborts. 

1. Statements that define the linkage between nodes and paths within each CU. 

2. Statements that define the linkage between SMs and CUs. 

Node I Path Linkage Statements 

These SSBLD statements are order-dependent. There are seven types of statements for a 
given CU and they must appear together in the following sequence and format: 

1. CUest=da,CH01=st,CH02=st,CH03=st,CH04=st. 

est EST ordinal of the CU (10 8 through 777 8 ). 

da Device address of CUest. 

st Channel status (ON or OFF). 

The CYBER channel number is associated with the 7990 channel interface (CIF) 
number. The position (first, second, and so on) of the channel in the CU statement 
minus 1 defines the CIF number wired to that channel. For example, CH02 is wired to 
CIFl. Also, if a single digit channel is used to connect to a 7990, it must have a leading 
in the CU statement. For example, channel 3 is entered as CH03. 
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2. CIFn=DTIO=st , DTIl=st , DTO0=st , DT01=st . 

n Device address of CIF (0 through 3). 

DTI Data transfer input. 

DTO Data transfer output. 

st Data transfer status (ON or OFF). 

3. DTIn=DIFO=St,DIFl=St. 

n Device address of DTI (0 or 1). 

DIF Device interface. 

st Device interface status (ON or OFF). 

4. DTOn=DIF0=st,DIFl=st. 

n Device address of DTO (0 or 1). 

st Device interface status (ON or OFF). 

5. DIFn=DRCO=st,DRCl=st. 

n Device address of DIF (0 or 1). 

DRC Data recording controller. 

st Data recording controller status (ON or OFF). 

If two DRCs exist in a CU, their device addresses must be paired as and 1 or 2 and 3. 

6. DRCn=DRDO=st, . . . ,DRD7=st. or DRCm=DRD8=st DRD15=st. 

n Device address of DRC (0 or 1). 

m Device address of DRC (2 or 3). 

DRD Data recording driver. 

st Data recording driver status (ON or OFF). 

DRCs and 1 can link only to DRDs to 7, and DRCs 2 and 3 can link only to DRDs 8 
to 15. 

7. AIFn=ACO=st,ACl=st,AC2=st,AC3=st. or AIFn=AC4=st,AC5=st, AC6=st, AC7=st. 

AIF Accessor interface. 

n Device address of AIF (0 or 1). 

AC Accessor. 

st Accessor status (ON or OFF). 

An AIF can link to either ACs in the range to 3 or 4 to 7, but not to ACs from both 
ranges. 
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SM I CU Linkage Statements 

The SM statement defines the linkage between SMs and CUs; its format is: 

SMid=st , ACn, CUest , CUest , DRDa=st , DRDa=st, DS=d, ST=s . 

Parameter Description 

id SM identifier (A through H). 

st Status (ON or OFF). 

n Device address of AC (0 through 3). 

est EST ordinal of the CU(s) connected to SMid. 

a Device address of the DRD(s) connected to ACn. 

d Number of DRDs for destaging per storage module (0 to 2). Default is 1. 

s Number of DRDs for staging per storage module (0 to 2). Default is 2. 

SSBLD and SSEXEC use the common deck COMBUDT to define the amount of memory to 
reserve within SSEXEC for the unit device tables. Any attempt to change the number of 
SMs or CUs specified in the common deck will cause SSBLD to abort. 

SSBLD Example 

The first two SSBLD statements specify the total number of CUs and SMs in the following 
configuration. The first statement specifies CUs and the second statement specifies SMs. 
The rest of the statements define the 7990 configuration. 

l 
l 

CU41=0, ,CH23=ON, , . 

CIFl=DTI0=ON, ,DTO0=ON, . 

DTI0=DIF0=ON, DIFl=ON. 

DTO0=DIF0-ON, DIFl=ON. 

DIF0=DRC0=ON, DRCl=ON. 

DIFl=DRC0=ON, DRCl=ON. 

DRC0=DRD0=ON,DRDl=ON, ,,,,,. 

DRC1=DRDO=ON,DRD1=ON, ,,,,,. 

AIF0=AC0=ON, , , . 

SMA=ON, ACO , , CU41 , DRD0=ON , DRDl=ON , DS=1 , ST=2 . 

* COMMENT. 

An asterisk (*) in the first column of an SSBLD statement specifies a comment statement. 
Comment statements are not sent to the dayfile. 
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7990 Equipment Configuration Constraints 

Control paths and data paths within the 7990 configuration have certain constraints placed 
upon the allowable device addresses of the accessors and DRDs. The accessor numbers and 
corresponding DRD numbers are: 



Number 


DRD Numbers 





or 1 


1 


2 or 3 


2 


4 or 5 


3 


6 or 7 



Accessors and DRDs that are to be coupled to two controllers must have the same path 
numbers assigned from each controller. For example, if an accessor is plugged into accessor 
path 2 of CU1, then a DRD on the same storage module must be coupled to a DRC path of 4 
or 5 from CU1. If a second controller is to be attached to this same storage module, then the 
other accessor port must also be plugged into accessor path 2 of CU2 and a DRD must be 
coupled to a DRC path of 4 or 5 from CU2. 
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SSALTER 

SSALTER displays the current 7990 hardware configuration and allows an analyst to 
change the status of certain elements in the 7990 configuration. SSALTER works with 
SSEXEC to make the specified changes to the existing 7990 configuration. 

The initial 7990 configuration file is built by the SSBLD utility and stored as a permanent 
file (default file name is BUDT) under user index 377760 8 on the default family. This 
configuration file is the unit device table read by SSEXEC during initialization. 

SSALTER can be run at SSEXEC initialization time or at any time after SSEXEC has been 
initialized. SSALTER aborts if SSEXEC is not executing. 

Console Input 

SSALTER can be executed only from the system console. Input from the console requires 
the following sequence of entries and responses: 

1. Call SSALTER by entering: 

X. SSALTER. 

The B,0 display indicates the job sequence name (jsn) of SSALTER. To the right of the 
entry appears the message: 

REQUEST *K* DISPLAY 

2. Activate the K display for that control point by entering: 

K, jsn. 
In this entry, jsn is the job sequence name of SSALTER as specified on the B,0 display. 

3. Select the desired K display by entering one of the following: 

K.SM=id. 

This entry selects the SM K display (figure 11-16), which shows the 7990 configuration 
of the storage module and DRDs complete with status information (id is the SM 
identifier, A through H). 

K.CUest. 

This entry selects the CU K display (figure 11-17), which shows the status of various 
paths/nodes in the specified control unit (est is the EST ordinal of the CU). 
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7 990 SUBSYSTEM - SSALTER 

PCU SCU SM/DRD 
ST ST ST 

SM A 42U U 



DRD 



DRD 



VALID COMMANDS ARE - 
K.SMI,CUNN=S. 
K . SMI , DRDN , CUNN=S . 



K. 



I = SM IDENTIFIER 

N = DRD DEVICE ADDRESS 

NN = CU EST ORDINAL 

S = STATUS - U FOR ONLINE 
F FOR OFFLINE 
M FOR MAINTENANCE 

+ = DISPLAY NEXT SM 



Figure 11-16. SM E Display 

When a DED's status is changed to online, any cartridges in the DRD are placed in service 
cells if space is available; otherwise, they are ejected from the storage module. A clear 
cartridge is then loaded into the DRD, its cartridge label and CSN are checked, and it is 
unloaded. The same cartridge is reloaded, its label and CSN are checked again, and the 
cartridge is returned to its cubicle. The service cells are then checked for cartridges. If a 
cartridge is found, it is either returned to the cubicle matrix or ejected from the storage 
module, depending on the cartridge label's contents. 

When a SM's status is changed to online, the accessor is first cleared of any cartridge it may 
contain. The cartridge is stored in a service cell if one is empty; otherwise, the cartridge is 
ejected from the storage module. The accessor then picks a clear cartridge from its cubicle, 
and immediately puts it back. If the SM's status is changed to online after SSEXEC has 
been initialized, the service cells are then checked for cartridges. Any cartridges found are 
ejected from the storage module. 
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Figure 11-17. CU K Display 
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MSE Operational Procedures 

Next is a summary of the operational procedures used in an MSE environment. These 
procedures include modifications to existing procedures and new MSE procedures, especially 
in the areas of permanent file backup and reloading and disk space management. Refer to 
the descriptions of the appropriate utilities for details about these operational procedures. 

Initialization 

MSE processing is initiated when the SSDEF utility is run to create the system files 
necessary to allow storage of files on 7990. SSDEF creates both an SM map for each SM 
that is to store file data on cartridges and eight 7990 catalogs (one for each subfamily) for 
each family that is to have 7990-resident files. Once these system files have been created, 
the SSLABEL utility can then be run to allocate portions of the SM to each subfamily and 
to initialize cartridges for use by files belonging to these subfamilies. Note that SSEXEC 
need not be executing when SSDEF is run, but SSEXEC must be executing when SSLABEL 
is run. 

When permanent files are defined, they reside on disk until the SSMOVE utility is run. 
Depending on the parameters specified, SSMOVE can destage files to 7990 and release the 
disk space assigned to files so that it is available for general use. 
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Disk Space Management 

The availability of disk space must be managed more frequently in an MSE environment 
than in a non-MSE environment. This is necessary because 7990-resident files must be 
staged to disk before a user can access them, and their disk space is not immediately 
released upon completion of the jobs that attached the files. Consequently, disks are apt to 
approach a disk-full condition unless the SSMOVE utility is used periodically to release disk 
space. 

The SSMOVE utility destages selected files to 7990 and optionally releases their disk space. 
It is recommended that the site analyst use SSMOVE as part of a periodic disk space 
management procedure and also just prior to a full dump to reduce the amount of data 
dumped to tape. (Refer to Dump Tape Management later in this section.) 

The E,M display can be used to monitor the tracks on a device or set of devices. When too 
few tracks (as defined by the installation) are available on the direct access devices for a 
family or subfamily, the SSMOVE utility should be run. SSMOVE reads the PFC entries for 
the specified family, selects certain files to reside on 7990, and decides which files should be 
released from disk. 

Files can be destaged to 7990 without their disk space being released. This destage-only 
feature can be used prior to a routine backup dump to create 7990 images for files with the 
BR=MD attribute and thereby eliminate the need to include them on a backup dump tape. 
(Refer to Dump Tape Management later in this section.) Having a 7990 image also provides 
backup for the file in special cases where the permanent file is being updated at the same 
time PFDUMP is being run. 

The destage-only feature can also be used to allow disk space to become available 
immediately when SSMOVE is run again. That is, SSMOVE can directly release disk space 
of files that have both disk and 7990 images but are to reside on 7990 only. However, for 
files that have no 7990 image, there is a delay before the disk space can be released because 
these files must first be destaged to 7990. 

Permanent file PFGMSE1 contains sample procedures FREEDSK and DESTAGE to show 
how a site may use SSMOVE for disk space management. FREEDSK waits in the rollout 
queue for a low disk space threshold flag to be set. FREEDSK is then rolled in for execution 
and calls SSMOVE to release disk space. The DESTAGE procedure calls SSMOVE at set 
times to destage files to 7990 whose file size in PRUs falls within the range specified by the 
MN=min and MX=max parameters. Each site can change the SSMOVE parameters and 
directives in the sample procedures to satisfy their requirements. 

NOTE 

Before using the FREEDSK and DESTAGE procedures, you must call the SSCONTL 
procedure to build the programs necessary to monitor the low disk space threshold and the 
time. 
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7990 Space Management 

The availability of 7990 space must be managed because 7990 space is not automatically 
released when a permanent file is purged. This allows you to perform a permanent file 
recovery to a time prior to the purging of the file. On a typical dump tape, the entry for a 
7990-resident file includes the PFC and permit entries, but not the file data. A subsequent 
reload operation recovers only what was dumped; the PFC and permit information, but not 
the file data. Thus, 7990 space for a purged permanent file cannot be released until you no 
longer need to recover the file data, because the file data resides on 7990 only and typically 
not on any dump tape. 

A 7990-resident file is stored only on the cartridges within the cubicles of SMs assigned to a 
subfamily. When destaging a file to 7990, SSEXEC selects the SM with the most space 
available. If no SM has enough free space to store the file being destaged, SSEXEC 
abandons that destage request, issues a message to the dayfile, and continues to destage 
other files that fit on the available 7990 space. To avoid this problem, use the SSVAL utility 
periodically to release 7990 space for purged files, thereby making it available for reuse. 

When you want to reuse 7990 space currently allocated to files that have been purged, 
he/she runs SSVAL with the RF and RL parameters specified. The RF parameter specifies 
an RDF, which is an auxiliary file produced by the permanent file utility PFDUMP and 
which contains versions of the 7990 catalogs and PFC entries that were current at the time 
of the dump. SSVAL examines the RDF to identify unneeded 7990 files (those without PFC 
entries) and their 7990 space is released. Choose which RDF to use based on the date and 
time of the dump that produced it. That is, a particular RDF is used only if there is no need 
for a permanent file recovery to a time prior to the dump that produced the RDF. 

Once an RDF is used by SSVAL to release 7990 space, you should discard it and any other 
RDFs for the same set of devices. These RDFs cannot be used as input to SSVAL in any 
future run. The MSE software does not permit an RDF to be specified by the RF parameter 
on an SSVAL call, unless it was produced by PFDUMP after the last SSVAL run that 
released 7990 space was completed. This prevents the inadvertent release of 7990 space 
that was previously released and reassigned to a file. 
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Example 1: 

Assume that two PFDUMPs were run a week apart producing two release data files, RDF1 
and RDF2. Assume, also, that according to both RDF1 and RDF2, file AFILE is an orphan 
(it has been purged but still resides on 7990). If the following call to SSVAL is made, the 
7990 space assigned to AFILE is released and made available for reuse, if no errors were 
encountered. 

SSVAL , RF=KDF1 , RL . 

Now, suppose that a new file, BFILE, which did not exist when RDF1 and RDF2 were 
produced, is assigned to the 7990 space on which AFILE has resided. If SSVAL were to 
accept either RDF1 or RDF2 on a subsequent SSVAL call, the 7990 space allocated to file 
AFILE (which is now the space where BFILE resides) is released. However, any RDF 
created after the SSVAL run that purged AFILE would not have an entry for AFILE and, 
hence, SSVAL would not inadvertently release the 7990 space presently allocated to BFILE. 

After SSVAL uses a release data file to release 7990 space, the corresponding backup tape 
from PFDUMP is the oldest tape that should be used for the first reel of a future 
incremental load. The first reel determines which files are to be reloaded according to the 
CIR on the tape (refer to PFLOAD in section 17, Permanent File Utilities). Use of an older 
tape as the first reel can allow the PFC entry for a purged file to be restored even though its 
7990 space may have been reassigned. The MSE software does not prevent loading from the 
wrong dump tape, but does detect as an error an attempt to stage a file whose data was 
overwritten (see Example 2). 

Example 2: 

Assume that RDF1 and RDF2 are as in the previous example, and that file CFILE is an 
orphan according to RDF2, but not according to RDF1. The following SSVAL call releases 
7990 space allocated to CFILE. 

SSVAL , RF=RDF2 , RL . 

Now suppose that the dump tape created by the PFDUMP run that produced RDF1 is used 
as the first reel of an incremental PFLOAD. Then the PFC and permit entries for file 
CFILE are reloaded, but, in fact, file CFILE does not exist on 7990. This will be detected as 
an error when a user attempts to attach CFILE. 
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Backup and Recovery 

Permanent file backup and recovery methods in an MSE environment are similar to those 
in a non-MSE environment. It is assumed that most sites with disk-resident permanent 
files have a file backup procedure consisting of a full dump followed by a series of 
incremental dumps. The assumed reload procedure is to load from tapes starting with the 
most recent incremental dump tape and continuing through older incremental dump tapes 
until the most recent full dump tape is processed. These procedures can be modified as 
follows to accommodate 7990-resident files. 

File Dumping 

The normal backup dump procedure is to dump files based on the modification date field in 
the PFC entries for the files. New parameters to PFDUMP provide the capability to dump 
files that have been modified during a certain interval, which is useful in recycling old 
dump tapes (refer to Dump Tape Management later in this section). For files that reside 
only on 7990, you can either stage the file to disk and thereby include it in the dump or 
suppress staging and include only the file's PFC and permit information on the dump tape. 
If the device or family being dumped has 7990-resident files, the following procedures 
should be included with the normal dumping procedures. 

Full Dumps 

Full dumps should be performed as usual, but OP=S should be specified on the call to 
PFDUMP to suppress staging. Thus, all files on disk are dumped but only the PFC and 
permit entries for 7990 files without disk images are included in the dump. It is 
unnecessary and not feasible to dump the files that reside only on 7990. Specify OP=S and 
SD on the call to PFDUMP; use the RD=filename parameter at your own discretion. 



Parameter 



OP=S 



SD 



RD=filename 



Description 



Selects no staging. If the SD option was inadvertently used on any 
previous nonincremental dump, an incremental dump should be taken 
prior to the full dump. 

Updates the dump date/time field on each master device dumped to 
permit files created or modified prior to tins dump to be released when 
SSMOVE is run again. Refer to Destage and Release Algorithms 
earlier in this section. 

Specifies that PFDUMP is to write a release data file to be used later 
by SSVAL. RD=filename is included or excluded on a call to PFDUMP 
depending on how often you want to purge unneeded 7990 files. 
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Incremental Dumps 



Incremental dumps should be performed as usual. No staging should occur because any files 
that were created or modified since the last dump will still be on disk if a tape backup is 
required. The following parameters should be specified on the call to PFDUMP. 

Parameter Description 



OP=M Selects incremental dumps. 

SD Updates the date/time field on each master device dumped, as 

previously described for full dumps. 

AD=yymmdd Selects the date just prior to the previous incremental or full dump of 

and the device. Hence, all files not included in the last dump are dumped. 

AT=hhmmss 

The following parameters should be used with caution. 

Parameter Description 

OP=S Selects no staging. If the SD option was inadvertently used on any 

recent partial dump, OP=S should not be specified so any file with a 
BR=Y attribute that had its disk space inadvertently released will be 
included in the dump. 

RD=filename Specifies that PFDUMP is to write a release data file to be used later 

by SSVAL, as previously described for full dumps. 



Dump Tape Management 

In a non-MSE environment, it is possible to make all previous dump tapes available for use 
after a full dump is completed. However, in an MSE environment, such dump tape recycling 
cannot occur because files that have resided only on 7990 for some time are probably not 
included on any recent dump tape. When a low percentage of files on a tape are active files, 
it is possible to redump any remaining files in order to recycle the tape by running 
PFDUMP and specifying OP=M, BD, and BT parameters, but not specifying the OP=S 
parameter. 4 This performs a dump of all files that were last dumped before the date and 
time specified on the PFDUMP call. If necessary, files will be staged in from 7990; after the 
dump is completed, the disk space for these staged files is released. Thus, files that might 
not be on any dump tape made after the date specified by the BD parameter are dumped 
and tapes created before this date can be recycled. 



4. It is possible to specify the AD and AT parameters also, thereby dumping files that were dumped during an interval after the 
date and time specified by AD and AT and before the date and time specified by BD and BT (refer to parameters for PFDUMP). 
This performs a dump of all files last dumped during the interval specified (including 7990-resident files) and allows your site to 
recycle all dump tapes created during this interval. 
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The number of dump tapes created can be reduced by using SSMOVE to reduce the amount 
of data written on these dump tapes. If SSMOVE is run prior to an incremental dump, files 
with the BR=MD attribute can be destaged to 7990 and excluded from the dump. That is, 
the incremental dump will exclude the files with a BR=MD attribute that are on both 7990 
and disk. If SSMOVE is run prior to a full dump, disk space for files that do not have to be 
on disk can be released and these files are not written on the dump tape. The following 
procedure involving dumps and SSMOVE runs can be used for efficiency. 

1. Run SSMOVE to destage files with the BR=MD attribute. 

2. Take an incremental dump to back up files with the BR=Y attribute. 

3. Run SSMOVE to release the disk images of files backed up in step 2. 

4. Take a full dump to reduce the number of dump tapes involved if a reload is required. 

SM Map 1 7990 Catalog Backup 

An SM map is created for each SM in an MSE environment and is updated by the 
SSLABEL, SSVAL, and SSDEBUG utilities. (Refer to the definition of SM map earlier in 
this section.) It is recommended that the SM map be copied on tape or on another device or 
family immediately after every update of the SM map. PFDUMP can be used to do this by 
dumping user index 377760 8 with FM equal the default system family name, but only if 
SSEXEC is not running. When SSEXEC is executing, it has the SM map files attached in 
modify mode; hence, PFDUMP will not dump the SM maps. 

If the device containing subfamily of the default family is reloaded, the latest SM maps 
should be recovered from the backup copies. After recovering the SM maps, run the SSVAL 
utility with the AM and FM parameters specified to ensure that the SM map and 7990 
catalog entries match. If they do not, corrective action should be taken as described in Error 
Conditions and Corrective Actions later in this section. Failure to retain or recover the 
latest SM maps can cause problems with future SSLABEL runs (refer to the definition of 
SM map earlier in this section). 

A 7990 catalog is created for each subfamily of a family that can have 7990-resident files 
and is updated by the SSLABEL, SSMOVE, SSVAL, and SSDEBUG utilities. When 
PFDUMP copies permanent files to tape for a master device or all devices in a family, it 
ensures that corresponding 7990 catalogs are also dumped. (If SSEXEC has a 7990 catalog 
attached in modify mode, PFDUMP interfaces with SSEXEC so that the 7990 catalog is 
included on the dump tape. While PFDUMP is accessing the 7990 catalog, any file destage 
requests for that subfamily are delayed.) Consequently, if PFLOAD is used to reload all 
files, the 7990 catalogs are automatically recovered and entries for all 7990-resident files 
reflected in recovered PFC entries will exist in the recovered 7990 catalog. 

If PFLOAD is run after the SSLABEL utility has updated the 7990 catalog and SM map but 
before the 7990 catalog has been backed up, the recovered 7990 catalog will not match 
exactly the corresponding SM map. In this case, recovery procedures (as described in 7990 
Catalog/SM Map Mismatch later in this section) must be taken to bring the SM map, 7990 
catalog, and cartridge label information into agreement. 
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File Reloading 

PFLOAD runs should be made as usual. PFLOAD reads the CIR records from the most 
recent incremental dump tape to control loading of file data and PFC and permit 
information. For 7990-resident only files, PFLOAD reloads only the PFC and permit 
information (if PFDUMP dumped only this information). The following situations involve 
PFLOAD in an MSE environment. 

• If one device needs to be reloaded, the DN or TD parameter specifies the device. The 
OP=Z and UD parameters should not be specified. 

• If PFLOAD is used for other than a device recovery, both OP=Z and UD should be 
specified. The OP=Z parameter ensures that the PFC entry does not link to a 7990 file 
that may no longer exist, and UD ensures that the file is included in the next 
incremental or full dump. 

• If a file has a nonzero asa value in its PFC entry (indicating that the file has a 7990 
image), the SSCVER flag in the PFC entry will be set when the PFC and permit 
information are reloaded. If the file is successfully staged to disk when it is attached, 
this flag is cleared. Otherwise, the flag remains set. This can be used to indicate the 
possibility of an operational error, such as omitting OP=Z when a file or set of files is 
reloaded from an obsolete dump tape. 

• If any unscheduled device reload that includes recovery of a 7990 catalog and/or SM 
map is made, SSVAL should be run with the AM and FM parameters specified. SSVAL 
examines the PFC entries for 7990-resident files, the 7990 catalog, and the SM map to 
detect any error conditions that exist. 

• If dumping a file to tape from one user and then reloading the file to a different user, 
you must use the OP=Z parameter on the PFLOAD utility. Otherwise the PFC entry 
still points to the old SFMCAT, which causes an error indication for the file. 
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Error Conditions and Corrective Actions 

It is possible for operational, hardware, or software malfunctions to cause a variety of error 
conditions to exist or appear to exist in the 7990 catalogs, SM maps, PFC entries, or 
cartridge labels. The SSVAL utility can analyze the 7990 catalogs, SM maps, and PFC 
entries to detect these errors, and the SSLABEL utility can identify problems with cartridge 
labels. The following paragraphs describe some specific error conditions and the actions that 
should be taken to correct them. Most of the errors are caused either by incorrect 
operational procedures that result in the recovery of the wrong version of an MSE system 
file, or by abnormal termination of SSEXEC or MSE utility processing, which can interrupt 
the updating of an MSE system file. 

Clearing Permanent File Error Flags 

The permanent file error flags that have been set by SSEXEC in the PFC can be cleared by 
the CE parameter of the CHANGE command. The job must be of system origin. 

Permanent File Recovery 

If a permanent file cannot be accessed or is included by SSVAL on the validation report, try 
the following procedures to recover a copy of the file. 

1. Attach the file. If the file has a disk image or can be staged in from 7990, the file data 
will be available on disk and can be copied to another file. SSVAL should then be run 
as described in step 2. 

2. If the file cannot be attached, reload the file from a dump tape using PFLOAD with 
OP=Z. To identify the PFDUMP run that saved a backup copy of the file, check the 
output from SSVAL or PFCAT, which includes date and time fields from the PFC entry 
for the file. Depending on the BR attribute (backup requirement) of the file, a backup 
copy on a dump tape may not exist. 

If the file can be reloaded to disk, SSVAL should be run as follows: 

SSVAL, FM=f amilyname , SB=subf amily , FX=n, AM. 

familyname and subfamily identify the family and subfamily of the recovered file and n 
is sufficiently large that the fixing/flagging will be done. SSVAL sets the obsolete flag in 
the PFC entry because the file now has a disk image; thus the file is disassociated from 
the error condition. The error condition may still exist in the 7990 catalog or SM map, 
but you can analyze it and correct the error by using the SSDEBUG utility. Before 
using SSDEBUG to correct the error, you should take an incremental dump so the old 
PFC entry with an asa value pointing to a problem 7990-resident file will not be 
reloaded if a device reload occurs before the next scheduled backup dump. 

3. If steps 1 and 2 fail, try to regenerate the file. Depending on the particular problem and 
status of the cartridges to which the file was destaged, the OP=RF or OP=RS directive 
to SSDEBUG might recover the file data. 

4. If the file cannot be recovered, purge it so there is no PFC entry pointing to a problem 
7990-resident file. 
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Cartridge Restoration and Reuse 

If a cartridge is unexpectedly found anywhere outside its assigned cubicle, follow these 
steps to restore the cartridge so it can be used again: 

1. Put the cartridge in the input tray of the SM to which it is assumed to belong and run 
SSLABEL with the OP=RC directive. If the cartridge label information agrees with the 
SM map entry for the cubicle with the coordinates (y,z) written on the cartridge label, 
the cartridge will be restored to that cubicle and the 7990 catalog entry for the 
cartridge is updated to clear the lost flag. Otherwise, the cartridge is put in the exit 
tray and the cartridge label information is included in the output from SSLABEL. 

2. If the cartridge was not restored to its SM cubicle, examine the label information 
reported by SSLABEL. If the cartridge is assigned to a different SM, repeat step 1 
using the correct SM. If the family name is blank, the cartridge has a scratch label and 
can be assigned normally with the OP=AM directive to SSLABEL. 

3. If steps 1 and 2 fail, examine the SM map entry for the cubicle with the coordinates 
(y,z) written on the cartridge label to see how the cubicle is assigned. Examine the 
cartridge, if any, in this cubicle. Also, it might be useful to run SSVAL to ensure the 
SM map and 7990 catalog entries for the cartridge match or to identify affected 
permanent files, if any, if they do not match. 

4. If step 3 does not produce any useful information and the cartridge cannot be restored, 
use the OP=FX directive to SSLABEL to rewrite the cartridge label and thereby make a 
scratch cartridge. It might be useful to first run SSDEBUG with the OP=RS directive 
to preserve the data on the cartridge. 



Removal of Faulty or Missing Cartridges 

Follow these steps to remove a cartridge that has unrecoverable errors, or to release the SM 
map entry for a cartridge that is missing. 

For unallocated cartridges: 

1. Attempt to remove the cartridge with the SSLABEL OP=RM directive. 

2. If CARTRIDGE NOT FOUND is reported, repeat step 1 specifying the LT parameter. 

3. If CARTRIDGE NOT EMPTY is reported, at least one AU on the cartridge is still 
allocated. 

For allocated cartridges: 

1. Use the SSLABEL OP=FC directive to inhibit further allocation of the cartridge. 

2. Run SSVAL specifying the AM parameter. Examine the report for possible discrepancies 
between the SM map, 7990 catalog, and PFC entries related to this cartridge. 

3. If no 7990 catalog entry corresponds to the SM map entry, use the OP=RC directive to 
SSDEBUG to remove the map entry. 

4. If no discrepancy is reported by SSVAL, the affected files should be attached in write 
mode (if possible), reloaded using PFLOAD with the OP=Z parameter, or purged. Then 
SSVAL release processing should be done to release the 7990 space on the cartridge, 
and the cartridge can be removed with the SSLABEL OP=RM directive. 
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7990 Catalog/SM Map/PFC Problems 

If error conditions exist in the 7990 catalogs or SM maps, the recovery procedure is to 
correct the appropriate entry rather than reload the entire file. Reloading other than the 
latest copy of the SM map is not feasible because it can contain entries for several families 
and these entries would not be up to date. Reloading an old copy of the 7990 catalog is not 
desirable because any permanent file that was destaged and released from disk since the 
last incremental dump will be lost. The following paragraphs describe corrective action for 
specific problems with 7990 catalogs, SM maps, or PFC entries. 

7990 Catalog ISM Map Mismatch 

The following examples of 7990 catalog/SM map mismatches can appear as error type 1 or 2 
on the SSVAL output report, which identifies the mismatch and the permanent files or 
orphans affected. Before taking any corrective action, the analyst should ensure that 
operational errors did not result in loading the wrong version of the SM map or 7990 catalog. 

• If a cartridge has a 7990 catalog entry indicating that all AUs on the cartridge are 
available for allocation but is not identified in any SM map entry (type 1 mismatch), use 
the OP=RL directive to SSDEBUG to remove the 7990 catalog entry for the cartridge. 

• If a cartridge is identified in an SM map entry but has no 7990 catalog entry (type 2 
mismatch), use the OP=RC directive to SSDEBUG to update the SM map entry to 
unassigned and empty status. This directive will write a scratch label for the cartridge, 
if any, and place the cartridge in the exit tray. 

• If a cartridge has a 7990 catalog entry indicating that at least one AU on the cartridge 
is allocated, recover the disk space for the affected permanent file, if any, or purge the 
file. Run SSVAL to purge unneeded 7990 files and thereby make the cartridge 
unallocated. Use the OP=RL directive to SSDEBUG to remove the 7990 catalog entry 
for the cartridge. 

NOTE 

It sometimes takes two SSVAL/SSDEBUG runs to completely clear up type 1 or type 2 
errors. Therefore, it is recommended that SSVAL be rerun with the AM parameter after an 
SSDEBUG run using OP=RC or OP=RL. 
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7990 Catalog Chain Problems 

AUs that are allocated to a 7990-resident file are chained together in the 7990 catalog to 
identify the sequence of AUs that contain the file. (Refer to the definition of cartridge 
earlier in this section.) For most files, the AUs in the chain reside on the same cartridge. 
Hence, one disk access is sufficient to update information for the entire chain at one time. 
However, a 7990-resident file can reside on several cartridges, and several disk accesses 
may be necessary to update its chain. If SSEXEC is interrupted during such an update, the 
resultant chain will be incomplete. SSVAL identifies incomplete chains as error type 4, 5, or 
6 on the validation report. The following are types of incomplete chains. 

• If an incomplete chain is produced while a 7990-resident file is being purged, it is a 
chain fragment (one without an HOC entry). 

• If an incomplete chain is produced while a file is being destaged to 7990, it is an 
ill-formed chain (one without an EOC entry). 

• If an ill-formed chain is not corrected, the AU that should have been linked to it may be 
reused and become part of a good chain. Although the ill-formed chain may appear to 
be complete, the ill-formed chain and the good chain are intersecting. 

The corrective action for any of these bad chain conditions is: 

1. Run SSVAL with the FM parameter specified and use a sufficiently large FX=n value so 
that SSVAL updates the 7990 catalog entries affected by the problem chains. 

2. Recover the permanent files, if any, that have 7990 images potentially affected by these 
error conditions. (The SSVAL report identifies these files.) Use the procedure described 
under Permanent File Recovery earlier in this section. 

3. Take an incremental or full backup dump. This prevents PFC entries with inaccurate 
asa values or problem 7990 chains from being recovered if a device reload is necessary. 

4. Run SSDEBUG with the OP=RP directive to make each AU on the problem chain 
available for allocation. Thus, the AUs can be included in a new chain without any 
problems. In the case of intersecting chains, all chains that have an AU in common with 
another chain should be released before any further destage attempts; otherwise, errors 
will occur when a user tries to attach a file that is contained on an intersecting chain. 

PFC 1 7990 Catalog Mismatch 

It is possible that an old version of a 7990 catalog can be reloaded because of incorrect 
operational procedures. If so, the asa value in the PFC entry for a file can be invalid 
according to the obsolete 7990 catalog or can point to a problem chain. If the correct version 
of the 7990 catalog is available on tape, it should be reloaded. If it is not available, the 
following action is appropriate. If the file also has a disk image, SSVAL should be run to 
clear the asa field in the PFC entry. If there is no disk image, the analyst should reload the 
file from tape, if possible, and then run SSVAL to clear the asa value. 
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Introduction 

This section describes the use of magnetic tape and optical disk as alternate storage media 
for NOS permanent files. 

Terminology 

The following terms apply to the use of tape and optical disk alternate storage. 
Alternate Storage 

The storage of permanent file data on external media other than mass storage. The 
storage media can be tape, MSE, or optical disk. When a file resides on alternate 
storage, the file's permanent file catalog (PFC) entry and permit data still reside on 
disk hut the disk space occupied by the file data can be released. 

Alternate Storage Address (ASA) 

The pointers in a file's PFC entry that point to the location of the file data on tape, 
MSE, or optical disk alternate storage. 

Destage Dump Optical Disk Volumes 

Optical disk volumes that contain files that were destaged from disk using both the 
REQOD command and the PFDUMP utility with the DT parameter specified. 

Destage Dump Tapes 

Tapes that contain files that were destaged from disk using the both the LABEL 
command and the PFDUMP utility with the DT parameter specified. 

Destaging 

The process of creating an alternate storage copy of a file on tape, MSE, or optical disk. 
Files are destaged to tape alternate storage when the site executes PFDUMP with the 
DT parameter specified and the file specified by the T parameter is assigned to a 
magnetic tape. Files are destaged to optical disk when the site executes PFDUMP with 
the DT parameter specified and the file specified by the T parameter is assigned to 
optical disk. Files are destaged to MSE when the site executes SSMOVE with the 
appropriate parameters. 

Permanent File Catalog (PFC) 

The system catalog containing the file name, owner identification, disk pointers, 
alternate storage pointers, and other attributes of a permanent file. Refer to Permanent 
File Catalog Entry in section 17, Permanent File Utilities, for the format of the PFC 
entry. 
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Primary VSN 

Either the volume serial number (VSN) of a single-volume destage dump or the VSN of 
the first volume of a multivolume set of destage dumps. The VSN must be two 
alphanumeric characters followed by a four-digit decimal number; the number must be 
in the range 0000 through 4095. 

Secondary VSN 

Either the VSN of a single-volume destage dump or the VSN of the first volume of a 
multivolume set of destage dumps having a sequence number (the last four characters 
of the VSN) in the range 5000 through 9095. The existence of a secondary VSN 
assumes the existence of a primary VSN having the same two-character prefix and a 
sequence number of 5000 less. The primary and secondary VSNs, or multivolume sets, 
are assumed to contain identical data although the individual volumes of multivolume 
sets cannot be assumed to be identical. 

Staging 

The process of restoring file data to disk residence from a copy on alternate storage. 
Staging is initiated when a user executes an APPEND, ATTACH, GET, or OLD 
command for a file that is not currently disk resident. 
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Organization and Management of Destage Dumps 

Destage dump tapes and destage dump optical disk volumes have different media 
characteristics and data formats. In addition, you use different procedures to manage 
destage dumps tapes and destage dump optical disk volumes. The destage dump tapes are 
described first. 



Tape Characteristics 

Destage dump tapes must be labeled 9-track tapes, ACS tapes, or CTS tapes with a tape 
format of either I or LI. Nine-track tapes should be written with a GE tape density. 
Although it is possible to have multivolume sets of tapes, create single volumes whenever 
possible to avoid the overhead of volume switching when restoring files to disk. 

The recorded VSN of the first tape of a set of destage dump tapes must be in the following 
format: 

ppnimn 

where pp is a prefix consisting of any two alphanumeric characters and nnnn is a decimal 
sequence number in the range from 0000 through 4095 or in the range from 5000 through 
9095. If the sequence number is 5000 or greater, the secondary tape set is assumed to be a 
duplicate of a primary tape set that has the same prefix and a sequence number of 5000 less. 



Tape Data Format 

All destage dump tapes are written by PFDUMP and have exactly the same format as other 
tapes written by PFDUMP including file permits. However, no PFC-only files are present on 
destage dump tapes. You can also load, copy, or list files from a destage dump tape using 
the PFLOAD, PFCOPY, or PFATC utility, respectively. 



Destaging Files to Tape 

Destage dump tapes are created by executing PFDUMP with the DT (destage to tape) 
parameter specified. When the DT parameter is used, PFDUMP verifies the following: 

• The dump file specified by the T parameter must be assigned to a labeled 9-track tape, 
ACS tape, or CTS tape that is recorded in either I or LI format. The VSN must be in 
the format ppnnnn, as described earlier in Tape Characteristics, and the sequence 
number must be in the range from 0000 to 4095. 

• If a verify file is specified (VF parameter), it must be assigned to a labeled tape of the 
same type, density, and format as the tape specified by the T parameter. Its VSN must 
have the following relation to the VSN for the primary dump tape: the two-character 
prefix must be the same and the sequence number must be greater by 5000. 

After the dump tape or tapes are successfully written, PFDUMP enters the primary dump 
tape VSN in the PFC entries of the dumped files. If a verify file is written, a flag is also set 
in the PFC entry indicating the existence of the secondary VSN. At this point, the disk 
space of the dumped files can be released, if necessary, as long as the file's backup 
requirements are satisfied. 
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Although general PFDUMP selection parameters can be used to directly select files for a 
destage dump, sites will normally use a separate file selection utility such as GENPFD to 
perform this function. (The GENPFD utility is described later in this section.) This 
procedure has the following advantages: 

• Files can be prioritized by the time since they were last accessed or modified. 

• Special user index or file name patterns can be special-cased according to site 
requirements. 

• The GENPFD selection utility can select files that will reasonably fill a single tape 
volume without overflowing to additional volumes. The creation of single volume tapes 
is desirable because it avoids the overhead of volume switching when files are restored 
to disk. 

When a file selection program such as GENPFD is used for destage processing, the following 
sequence of events should be followed: 

1. Execute PFDUMP with the IP (inhibit processing) and DT (destage to tape) parameters 
specified and the summary file selected with the S parameter. Specifying PFDUMP 
parameters such as LS, US, BD, BT, etc., can be used to screen out desired classes of 
files. The TA=N and CA=N parameters can be used to exclude files that already have 
current alternate storage copies (from previous destage dumps). 

2. Execute the file selection program (GENPFD) using the PFDUMP summary file as 
input. The file selection utility writes UI and PF utility directives for the selected files 
to the utility directives file. 

3. Reexecute PFDUMP (with the same parameters as specified in step 1, but without 
specifying the IP parameter) using the utility directives file generated in step 2 as an 
input file. 

When a destage dump is performed, files on user name SYSTEMX and on the MSE catalog 
user names SUBFAMO through SUBFAM7 are unconditionally excluded even if they meet 
the selection criteria. 

Example: 

Destage enough files to fill one tape (alternate storage) with files from family TEST whose 
data has not been modified since 87/07/01 and which have not been destaged already. 
Create two copies of the dump tape on VSNs AA1234 and AA6234. 

RETURN, SUMMARY. 

PFDUMP, FM=TEST,DT,OP=T r BD=870701,TA=N, IP, S. 

REWIND, SUMMARY. 

RETURN, UDIR. 

GENPFD, PO=D. 

REWIND, UDIR. 

LABEL, TAPE, VSN=AA1234, D=GE, W. 

LABEL, PFVER, VSN=AA6234 , D=GE, W. 

PFDUMP, FM=TEST, DT,OP=T, BD=870701 , TA=N, I=UDIR, VF . 

In this destaging example, if GENPFD does not find enough files to fill a 2400-foot tape at 
GE density, the utility does not generate a UDIR file. This causes the second PFDUMP to 
abort without dumping any files. 
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Tape Alternate Storage in a TMS Environment 

When a site is using Control Data's Tape Management System, special handling is required 
for permanent file destaging operations. For more information about TMS operations, see 
the NOS2 Tape Management System Site Operations Manual. The following information is 
provided as a brief background pertaining specifically to TAS. 

Normally when tapes are written under TMS, they are automatically assigned as requested 
from a pool of scratch tapes maintained for that purpose. Because a TAS destage VSN must 
take the form ppnnnn, do not assign a destage dump tape from the TMS scratch pool 
because there is no way to ensure that an appropriate VSN is assigned, for either the 
primary or secondary VSN. Therefore, it is necessary to maintain (separately from the pool 
of scratch tapes) a pool of tapes with VSNs that conform to the TAS format. 

To form a separate pool of TAS tapes, use the SYSTEM=YES directive when adding TAS 
tapes to the TMS database through TFSP. TMS does not allow VSNs with SYSTEM status 
to be part of the scratch pool. 

Once a TAS pool of tapes is established, TMS offers two tools that work together as one to 
aid in automated management of TAS VSNs at a site: the GETTASV command and the 
SETTASV procedure. GETTASV selects TAS VSNs from the site's pool of TMS SYSTEM 
VSNs, then calls SETTASV to reserve and request the selected tapes. 

The following example shows how GETTASV and SETTASV might be used in a destaging 
job to automate the process of assigning VSNs for destage dump tapes from the TMS 
database. In this example, cartridge tapes are used for destaging of files that belong to a 
particular family and have not been accessed since July 1, 1990. 



USER,usernam,passwrd, family. 



RESOURCE, CE=2. 

PFDUMP, IP, S , BD=900701, OP=A, FM=f amily, DT, TA=N. 
REWIND , SUMMARY . 
RETURN, UDIR. 

GENPFD,PO=D. 



IF, FILE {UDIR, .NOT. AS) .EXIT. 

TFSP, FM= family, SS=VSNS, OP=Z . /MREADVS= 
REWIND, VSNS. 

GETTASV, SS=VSNS , P=UR , N=2 , D=CE , F=LI . 

* (GETTASV CALLS SETTASV AT THIS POINT) 
REWIND, UDIR. 

PFDUMP, FM= family , I=UDIR, DT, VF . 
UNLOAD , TAPE , PFVER . 



User name, family are 
required. 

Ensure adequate resources. 

Select candidate files. 



Select actual files to be 
destaged. 

Exit if no files were selected. 

Select candidate VSNs. 

Select TAS SYSTEM VSNs. 
Reserve and request VSNs. 



Destage the files. 
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Optical Disk Characteristics 

Although optical disks used as alternate storage can be multivolume, create single volumes 
whenever possible to avoid the overhead of volume switching when restoring files to disk. 

The recorded VSN of the first volume of a set must be in the following format: 

ppnnnn 

where pp is a prefix consisting of any two alphanumeric characters and nnnn is a decimal 
sequence number in the range either from 0000 through 4095 or from 5000 through 9095. If 
the sequence number is 5000 or greater, the secondary VSN is considered to be a duplicate 
of a primary VSN that has the same prefix and a sequence number 5000 less. 

The destage dump set must have the following characteristics specified on the REQOD 
command: 

• The recorded file name must be PFARCHIVE (RFN=PFARCHIVE). 

• The owner identification or user name must be SYSTEMX (FOI=SYSTEMX). 

• The group identification or family name (FGI=name) must be the same as the family 
name you specify for the FM parameter on the PFDUMP command. 

The REQOD command is described in NOS Optical Storage Subsystem QSE32835 
Reference Manual. 

Optical Disk Data Format 

All destage dump optical disk volumes are written by PFDUMP and have exactly the same 
format as other dumps written by PFDUMP including file permits. However, no PFC-only 
files are present on destage dumps. You can also load, copy, or list files from a destage 
dump optical disk volume using the PFLOAD, PFCOPY, or PFATC utility. 
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Destaging Files to Optical Disk 

The procedure for destaging files to optical disk is identical to that for destaging files to 
tape, except that: 

• Rather than using the LABEL command to assign file TAPE to a magnetic tape, you 
use the REQOD command to assign file TAPE to an optical disk. The REQOD 
command and other aspects of optical disk usage are described in NOS Optical Storage 
Subsystem QSE32835 Reference Manual. 

• You specify the U=MB parameter on the GENPFD command to calculate the destage 
file size in megabytes. 

Refer to Destaging Files to Tape earlier in the section for more information on the destaging 
procedure. 

Example: 

Destage enough files to fill 102 megabytes of optical disk alternate storage with files from 
family TEST whose data has not been modified since 91/07/01 and which have not already 
been destaged. 

RETURN , SUMMARY , UDIR . 

PFDUMP, FM=TEST , DT , OP=T , BD=910701 , CA=N, TA=N, IP, S . 

REWIND , SUMMARY . 

GENPFD , PO=D , U=MB . 

REWIND, UDIR. 

REQOD , TAPE , VSN=AB12 3 4 , RFN=PFARCHIVE , FOI=SYSTEMX , FGI=TEST . 

PFDUMP, FM=TEST, DT, OP=T, BD=9 107 01 , CA=N, TA=N, I=UDIR. 

As required to destage to optical disk, the FGI parameter of the REQOD command matches 
the FM parameter of the PFDUMP command, and both RFN=PFARCHTVE and 
FOI=SYSTEMX are specified for the REQOD command. 
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Releasing Disk Space 

The disk space of a file that resides on alternate storage can be released if the file's backup 
requirements are met. The BR parameter on the DEFINE, SAVE, and CHANGE commands 
allows a user to specify a backup requirement of Y (yes), MD (media dependent), or N (none). 

Parameter 

Option Description 

BR=Y The disk space of a file with a backup requirement of BR=Y can be released 

if either of the following conditions is satisfied: 

• At least two copies of the file data exist on alternate storage media. This 
could be one copy on either MSE or optical disk and one copy on tape or 
two copies (primary and secondary VSNs) on tape. 

• One copy of the file data exists on an alternate storage medium (MSE, 
tape, or optical disk) and the release inhibit date/time of either the file's 
master device or the file's residency device (as set by a PFDUMP with 
the SD parameter specified) is greater than the file's utility control 
date/time. 

BR=MD The disk space of a file with a backup requirement of BR=MD can be 
released if the following condition is satisfied: 

• One copy of the file data exists on MSE, tape, or optical disk alternate 
storage. 

The PFREL utility is used to perform the releasing of disk space. As with PFDUMP, PFREL 
can be used with a file selection utility such as GENPFD in the following sequence of steps: 

1. Execute PFREL with the IP (inhibit processing) parameter specified and the summary 
file selected with the S parameter. Files can be excluded by specifying selection 
parameters. In particular, OP=A can be used with the BD and BT parameters to 
exclude files that have been accessed recently. 

2. Execute the file selection program using the PFREL summary file as input. The file 
selection utility writes UI and PF utility directives for the selected files to the utility 
directives file. 

3. Reexecute PFREL (with the same parameters as specified in step 1, but without 
specifying the IP parameter) using the utility directives file generated in step 2 as an 
input file. 

The PFREL utility can be used to release the disk space of files that reside on tape, MSE, or 
optical disk alternate storage. However, the MSE utility SSMOVE performs release 
processing only for MSE resident files. PFREL does not release the disk space of files 
cataloged on user name SYSTEMX or on the MSE catalog user names SUBFAMO through 
SUBFAM7 even if the selection criteria are met. 
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Example 1: 

The following example illustrates releasing disk space for destaged files. 

Release the disk space for all files from family TEST that have not been accessed since 
87/07/01 and for which backup requirements have been met. 

PFREL , FM=TEST , OP=A, BD=870701 . 

Example 2: 

Using the same file selection criteria as in example 1, release enough files so that 1000 8 
tracks are available on device number 40 and 1200 8 tracks are available on device number 
41. 

RETURN , SUMMARY . 

PFREL , FM=TEST , OP=A, BD=8707 01 , S , IP . 

REWIND, SUMMARY. 

RETURN, UDIR. 

GENPFD,PO=R,Z./RL,40,1000/RL,41,1200 

REWIND, UDIR. 

PFREL , FM=TEST , I=UDIR . 

Restoring Destaged Files to Disk Residence 

A file that does not reside on disk is restored to disk residence (staged) when a user accesses 
the file with an APPEND, ATTACH, GET, or OLD command. If the RT (real time) 
parameter is specified on an ATTACH, GET, or OLD command and staging is required, the 
job continues executing without waiting for the staging operation to complete. In this case, 
the caller must subsequently reissue the ATTACH, GET, or OLD command to access the file 
after the staging operation completes. 



NOTE 



To allow staging of files from 9-track tape and CTS tape alternate storage to disk, the site 
must enter the ENABLE.TAPE PF STAGING command (via DSD or IPRDECK). 

To allow staging of files from ACS tapes, the site must enter the ENABLE,ACS TAPE PF 
STAGING command (via DSD or IPRDECK) and must have the ATF subsystem active. 

In both cases, you must specify the SJ parameter on the MAGNET command in the MAG 
subsystem startup procedure. 
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Modifying Destaged Files 

When you modify a file having a copy or copies on alternate storage media, the data on 
alternate storage is no longer current. Therefore, when a direct access file is attached in a 
writable mode, or an indirect access file is saved or replaced, the system removes the 
pointers to all alternate storage copies in the file's PFC entry. At this point, the file must be 
destaged again (to tape, MSE, or optical disk) if it is to reside on alternate storage. 

Recycling Destage Dump Tapes 

As files are modified and purged over a period of time, new destage dump tapes are created 
and the percentage of active files on older destage dump tapes decreases. Destage dump 
tape recycling consists of procedures to move the remaining active files' data on old destage 
dump tapes to new destage dump tapes so that the old tapes can be reused. Performing a 
destage PFDUMP (DT parameter) with staging enabled (OP=S not specified) of all files on a 
tape or set of tapes copies all file data to a new tape and changes all alternate storage 
references from the old tapes to the new tape. 

Since only a subset of the files on tapes selected for recycling are typically active, a site 
normally wants to include other files to fill a new tape. The following example illustrates 
this procedure. 

RETURN , SUMMARY . 

PFDUMP, IP, S, DT, FM=TEST, TA=N, TA=AB0005 , TA=AB0006 . 

REWIND, SUMMAY. 

RETURN, UDIR. 

GENPFD,OP=D,Z./SV,AB0005/SV,AB0006/DL,2200/DT,0 

REWIND, UDIR. 

LABEL , TAPE , VSN=AB02 , D=GE , W . 

LABEL , PFVER , VSN=AB5 2 , D=GE , W . 

PFDUMP, DT,FM=TEST, I=UDIR,VF. 

The TA parameters on the first PFDUMP command select files residing on VSNs AB0005 
and AB0006 (the tapes being recycled) and files not residing on tape alternate storage as 
candidates for destage. The SV directives cause GENPFD to select all files residing on 
VSNs AB0005 and AB0006 regardless of the modification date derived priority and priority 
group. GENPFD selects other files using the normal priority criteria to satisfy the destage 
limit specified by the DL directive. The DT (destage threshold) directive performs a recycle 
dump even if there are not enough files selected to fill the tape. The two LABEL commands 
cause two copies of the dump: one on VSN AB0200 and the other on AB5200. 

To help determine which destage dump tape VSNs should be recycled, you may want to 
write a program that reads the PFCAT summary file and generates a list of how many files 
are still active on each destage dump tape VSN. 

You can determine if any current files reside on a particular destage dump tape VSN by 
executing PFCAT with the TA=vsn parameter specified. 

After you perform a recycle dump for a tape or a set of tapes, the tapes cannot be reused 
until a full or incremental PFDUMP has been performed on the affected devices. Without 
this PFDUMP, a permanent file reload could cause some of the reloaded PFC entries to 
refer to tapes that no longer exist. To prevent this problem, a tape recycling operation 
should always be immediately followed by a full or incremental PFDUMP. 
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MAGNET Command 

The MAGNET command has two parameters that must be used in a tape alternate storage 
environment. The SJ parameter controls the maximum number of staging jobs that can be 
active concurrently to stage files to disk from tape alternate storage; and the SV parameter 
controls the maximum number of staging request VSNs that can be displayed on the DSD 
E,P display. Refer to the NOS Version 2 Operations Handbook for a description of the DSD 
E,P display. 

The MAGNET command has the following format: 

MAGNET , SJ=ms j , SV=mvd . 
Parameter Description 



SJ=msj Specifies the maximum number of staging jobs that can be active at the 

same time (0 < msj < 30 8 ). The default is SJ=0; staging is not allowed. 



NOTE 



The SJ parameter must be specified or staging from tape alternate storage to 
disk will not be allowed. 

SV=mvd Specifies the maximum number of requests for staging tape VSNs to display 
on the DSD E,P display (1 < mvd < 77 8 ). The default is SV=17 8 . Requests for 
staging tape VSNs will appear first on the E,P display (before the normal 
tape requests) and can be distinguished by having a JSN of SYS and a user 
name of (STAGE). 



GENPFD Utulty 

The GENPFD utility controls file selection processing. It reads a summary file created by 
one of the permanent file utilities and uses the information to generate file selection 
directives for subsequent permanent file utility operations. 
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Calling the GENPFD Utility 

You call the GENPFD utility by executing the GENPFD command. The format of the 
command is: 

GENPFD, I=input, S=summary, UD=udir, PO=opt, U=units , Z .directives 

Parameter Description 

I=input The 1- to 7-character name of the file from which directives are read. 

The default file name is INPUT. 

S=summary The 1- to 7-character name of the summary file previously created by a 

permanent file utility. The default file name is SUMMARY. This file is 
used as input to GENPFD. 

UD=udir The 1- to 7-character name of the utility directives file to be created. 

This file is used for subsequent permanent file utility operations such as 
destaging files and releasing disk space. The default file name is UDIR. 

PO=opt The processing option that specifies whether to select files for destage 

processing or releasing disk space. Acceptable values for opt are: 

opt Description 

D Select files for destage processing. 
R Select files for releasing disk space. 



U=units 



Unit of measure for the destage limit and destage threshold directives 
(DL and DT). The default value is FT. Acceptable values for units are: 



units 



FT 

MB 



Description 



Measures in feet of tape. 
Measures in megabytes of storage. 



Z Input directives are contained on the GENPFD command following the 

terminator. If the Z parameter is specified, the I parameter is ignored. 
This eliminates the need to use a separate input file for the directives 
when only a few directives are needed. 

directives When input directives appear on the GENPFD command, the first 

character following the command terminator is the separator character 
for all directives on the command. Any display code character that is 
not used in any of the directives, including a space, can be used as the 
separator character. Each directive must be preceded by a separator. 
The directives can extend to column 72 on the command. Continuation 
lines are not permitted. 

For example, (slant used for separator): 

GENPFD, PO=D, Z. /D=PE/DL, 2200/SF, 3456 
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GENPFD Input Directives 

The GENPFD input directives provide the capability to selectively choose files for 
processing. The GENPFD utility accepts the following input directives: 



Directive 



Description 



D=density Density of the destage dump tape that is written by the destaging 

operation. GENPFD uses the density in calculating the length of tape 
necessary for the selected files. The following table lists the acceptable 
values for density; the default is 6250. 



density Description 

AE 38000 cpi (ACS tape) 

CE 38000 cpi (CTS tape) 

HD 800 cpi (9-track tape) 

PE 1600 cpi (9-track tape) 

GE 6250 cpi (9-track tape) 

1600 1600 cpi (9-track tape) 

6250 6250 cpi (9-track tape) 

38000 38000 cpi (cartridge tape) 



DL,limit Destage size limit used with the PO=D option. The U=units option 

determines whether the limit is measured in feet of tape or megabytes. 

Specify a 1- to 10-digit number as the limit; the limit is assumed to be 
decimal unless a B radix is specified. This directive specifies the 
maximum combined size of all selected files. It is intended to prevent 
writing beyond the end of volume when selecting files for destaging with 
the PFDUMP utility. If selection of a file causes the limit to be exceeded, 
the file is skipped and the next lowest priority file is examined. The 
default limit depends on the U=units option. If U=MB, the default is 
102 megabytes (an appropriate value for optical disk). If U=FT, the 
default varies with the D=density option. For 9-track tape densities, the 
default is 2200 feet, which allows for a significant number of tape errors 
on a 2400-foot volume of tape. For cartridge tape densities, the default 
is 500 feet, which allows for tape errors on a 530-foot cartridge. 
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Directive 



Description 



DT,threshold Destage size threshold used with the PO=D option. The U=units option 
determines whether the threshold is measured in feet of tape or 
megabytes. 

Specify a 1- to 10-digit number as the threshold; the threshold is 
assumed to be decimal unless a B radix is specified. This directive 
specifies the minimum combined size of all selected files. If the combined 
size of all selected files is less than the threshold, no utility directives 
file will be generated. This directive is used to ensure that enough files 
can be selected on a destage dump to reasonably fill the space available. 
The default value is 90 percent of the limit specified for DL. 

F=format Format used for the destage dump tape. The default format is I. 

Acceptable values are: 

Format Description 



I 
LI 



Internal format. 

Long block internal format. 



PG,p 1 ,p 2 ,p 3 Define preferred residence priority groups. The default is T,MN,D. The 

parameters p n are strings of preferred residence mnemonics which define 
the priority groups used in file selection. The groups are defined in 
order of decreasing priority. The default value defines three groups: 1) a 
high priority group consisting of files with PR=T (tape alternate storage 
residence preferred); 2) a medium priority group consisting of files 
having PR=M (cartridge alternate storage residence on either MSE or 
optical disk preferred) and PR=N (no preferred residence); and 3) a low 
priority group consisting of files having PR=D (disk residence preferred). 
Files having PR=L (file locked to disk) are excluded from selection. 

It is possible to define other than three groups. For example, the 
following entry: 

PCTMNDL 

places all files in one group, effectively causing preferred residence to be 
ignored. 

The following entry defines four groups. 

PG,T,M,N,D 

If a preferred residence type is not specified, files having that value are 
excluded from selection unless they are selected explicitly with an SF or 
SV directive. The following entry causes files with PR=D or PR=L to be 
excluded: 

PG,TMN 
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Directive 



Description 



RL,dn,tracks 
RL,dt,tracks 



SF,ui 



SV,V lf V 2> . 



•> v n 



XF,ui,fi,f2>-4 
XF,ui 



Define the track release limit for device number dn or device type dt. A 
device type is specified as a mass storage equipment mnemonic followed 
by a unit count. Files residing on a device are not released unless you 
enter an RL directive specifying either the device number or the device's 
type. A device number entry takes precedence over a device type entry if 
both apply. Files residing on the applicable device or devices are 
released until the number of available tracks reaches the specified limit. 
No release processing is performed for the device if the number of 
available tracks is equal to or greater than the specified limit. For 
example, the following device number entry: 

RL,40,300 

specifies that files should be released on device 40 until there are 300 
available tracks. If 300 tracks are already available, no files will be 
released. 

The following device type entry: 

RL,DQ2,250 

specifies a release limit of 250 tracks for each two-spindle 885 device for 
which a limit has not been specified by device number. 

Unconditionally select the specified files cataloged under user index ui, 
if found in the summary file. If no file names are specified, select all 
files cataloged under user index ui. 1 

Unconditionally select any files found in the summary file with tape 
alternate storage VSNs that match the specified VSNs. This directive is 
intended to be used when recycling destage dump tapes as part of 
destage processing. Specifying the VSNs of tapes to be recycled prevents 
files residing on those tapes from being excluded by the priority 
selection process. 1 

Exclude the selection of the specified files cataloged under user index ui. 
If no file names are specified, exclude all files cataloged under user 
index ui. 



1. The SF and SV directives cause GENPFD to treat the specified files as higher priority than others in the selection process. In 
some cases, GENPFD satisfies the specified destage or release limits without selecting all of the files. 
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File Selection Processing 

The GENPFD utility sorts the candidate files into preferred residence priority groups as 
determined by the PG directive. Within each group, each file is assigned a priority based on 
the time elapsed since the last access (if PO=R) or last data modification (if PO=D) with older 
files receiving higher priorities. Files selected with SF directives or files residing on VSNs 
selected with SV directives are given a higher priority than other files to force selection. 

For destage processing, files are selected beginning with the highest priority until the 
destage limit is reached. The permanent file utility parameters UI and PF are written to 
the utility directives file for each selected file unless the combined length of the selected 
files is less than the destage threshold (either the default or an explicit nonzero value 
specified in the DT directive). 

For release processing, files residing on devices specified by RL directives are selected for 
release until the defined limit for each device is reached. The permanent file utility 
parameters UI and PF are written to the utility directives file for all files selected for release. 

Limitations 

GENPFD can process a maximum of 80 RL directives and a total of 1000 SF, SV, and XF 
directives. Each directive counts as one entry, whether or not it contains a file name or VSN. 
Each file name or VSN on a directive after the initial one counts as an additional entry. 
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Introduction 

Multimainframe operation provides mechanisms by which more than one computer can 
share mass storage devices. Each mainframe in a multimain fr a m e configuration has access 
to the shared mass storage devices and their preserved files. Preserved files are those files 
that are retained across a level deadstart (nonsystem recovery). Types of preserved files 
are permanent files, queued files, and system dayfiles. 

There are two types of multimainframe configurations: 

• Linked shared device multimainframe (SDM). 

• Independent shared device multimainframe. 

The main difference between the two SDM configurations is their method of maintaining 
the critical device tables necessary to control shared mass storage and mtermainframe 
communications. Linked SDM configurations maintain the critical device tables in extended 
memory, while independent SDM configurations maintain the tables on each shared mass 
storage device. Because the independent SDM configurations maintain the tables on the 
shared devices, it causes some performance degradation. 

Each mainframe in a multimainframe configuration can operate in multimainframe mode or 
in standalone mode; however, two machines may not access the same device unless both are 
in multimainframe mode. A device is considered shared if it can be accessed by more than 
one of the mainframes; it need not be accessible to all mainframes in the complex. 

The fact that a computer is operating as part of a multimainframe complex is not apparent 
to the user, except for some degrading of performance for the independent SDM. However, 
there are operational changes and additions that the operator should note. These include 
deadstart commands, displays, online commands necessary in the event of an interruption 
on one of the sharing mainframes, and the UNLOAD/MOUNT process for removable devices. 

Recovery allows a machine to either join other machines operational in a mul tim a infr a m e 
complex or to operate in a standalone mode. The standalone system is not allowed to use the 
same mass storage devices as other machines. In the event of a system interruption to one 
machine, it is possible to operate the remaining machines in a multimainframe environment. 

Automatic detection of extended memory is not provided, because it is not possible to 
determine its absence and continue to run on all machine types. For example, a 6600 will 
hang if an attempt is made to execute an extended memory instruction without extended 
memory. Extended memory status is checked during deadstart when processing an 
extended memory entry in the EQPDECK. 

Except where explicitly specified that controllers and/or equipment can be shared between 
mainframes, assume they cannot be shared. For example, NOS does not support sharing a 
two-channel tape controller between mainframes; nor does it support sharing mass storage 
controllers except as specified in this section. 
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Linked SDM Operation 

In a linked SDM complex, up to seven computers can access mass storage devices. Any 
combination of 1 to 7 model 71, 72, 73, 74, 171, 172, 173, 174, 175, 176, 720, 730, 740, 750, 
760, 865, 875, CYBER 180-class machines or 6000 Computer Systems mainframes can be 
used. Most mainframes require one CPU port connected to extended memory. The 
exception is CYBER 180-class machines which must be connected to extended memory 
through a low-speed port (LSP) or a distributive data path (DDP) instead of a CPU port. 
Shared mass storage devices supported are: 844 (single and double density), 885-11/12, 
extended memory, and DAS (SSDs, SABREs, and ELITEs). 

Extended memory is the means for controlling shared mass storage and intermainframe 
communications. Each mainframe has a port into extended memory through which system 
activity is controlled. In order to control shared mass storage devices, several extended 
memory resident tables are required. The device access table (DAT) contains the logical 
description (family name/pack name and device number) of each mass storage device 
(shared or nonshared) that is accessible by any machine in the linked SDM complex. For 
each device in the DAT that is to be accessed by more than one machine, a corresponding 
MST (image of central memory resident MST) and TRT also reside in extended memory. In 
addition, a machine recovery table (MRT) exists in extended memory for each machine and 
device (that is, there are as many MRTs for each shared device as there are ma infram es in 
the complex). 

If shared buffered devices are configured, there also exists a buffer access table (BAT) and 
buffered device table (BDT) for each shared buffered device, as well as a buffer request table 
(BRT) for each mainframe. 

If MSE is used, one mainframe in the linked SDM complex is physically connected to 7990 
and is called the master mainframe; all other mainframes in the complex can access 7990 
files and are called slave mainframes. SSEXEC runs on the master mainframe and is the 
main processing program that controls MSE activity. SSSLV runs on each slave mainframe 
and communicates with SSEXEC to retrieve files from 7990 in response to ATTACH 
requests by jobs running on the slave mainframes. 
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Deadstart 

A linked SDM environment is defined at deadstart by CMRDECK and EQPDECK entries in 
each machine. Use the following entries to do this. 



CMRDECK Entry Description 



MID=id. 



2-character machine identification. This identification is used to 
associate a specific machine with its access to a shared device. 
It is required, however, even if no devices are shared during 
system operation. This id must be unique for each machine in 
the complex. If id is omitted, the default value is MID=AA. 



EQPDECK Entry 



Description 



SHARE=est 1 ,est 2 ,. . . .est,,. 



MAXSHARE=n,b. 



PRESET. 



EST ordinals of the mass storage devices that will be 
shared with other machines in the linked SDM 
complex. The MST/TRT for each device resides in 
extended memory. 

Optional; defines the total number of devices to be 
shared by all the mainframes in the complex (n), and 
the total number of buffered devices to be shared by 
all the m ainfram es in the complex (b). This entry is 
required only if shared devices exist which are not 
configured on all mainframes in the complex. If this 
entry is not specified, the default values are the 
number of shared devices and shared buffered devices 
defined for this particular mainframe. 

Initializes the flag register and the extended memory 
resident tables. You can specify this entry only at the 
system console. You must specify the PRESET entry 
on a level deadstart on the first machine to be 
deadstarted in the linked SDM complex. 



These entries are also described in section 3, Deadstart Decks. 

Because in a linked SDM complex two or more machines can utilize the same mass storage 
devices, the device assignments and EQPDECKs of all machines are interrelated. Care 
must be taken to ensure proper EQPDECK settings for each machine to obtain the desired 
device configuration. The following items are important in obtaining this proper device 
configuration. 

• Each machine must specify a unique machine identification (using the MID entry in the 
CMRDECK). This identification associates a particular machine with its files on a 
shared device. There are no external characteristics associated with this identification. 
However, if the machine identification specified on a machine deadstarting into a 
multimainframe complex is identical to a machine identification on a machine already 
operating, the deadstart process halts and an appropriate message is displayed. 

• The assignment of shared mass storage devices should be made properly to ensure the 
recoverability of the device and the proper operation of the system (refer to Shared 
Mass Storage later in this section). 
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• If SHARE EQPDECK entries are present, an extended memory entry (DE or DP 
equipment type) must also be present in the EQPDECK If none is found, an error 
message is given to the operator indicating that no link device has been denned. 

• The first machine deadstarted (level only) must specify the PRESET EQPDECK entry. 
This command causes tables to be preset in extended memory, and in so doing, assures 
that no other machine has arrived at the same point in the deadstart sequence and is 
attempting the same thing. These other machines should not have the PRESET entry 
specified during deadstart. All other machines that arrive at that point in the deadstart 
process display a message indicating that they are waiting for deadstart on the preset 
machine. A machine that does not preset extended memory has no means of detecting 
whether extended memory has been preset previously by another machine. Therefore, 
the operator must ensure that extended memory has been preset by a prior deadstart 
before deadstarting another machine that is to be in the multimainframe complex. 

• If extended memory is initially placed in maintenance mode (half of extended memory 
used for online diagnostics), the first machine deadstarted in a complex must have the 
INITIALIZE and PRESET EQPDECK entries specified when deadstarting (level 
only). The remaining machines must have the extended memory size correspondingly 
reduced in their EQPDECKs. 

When a mainframe joins a linked SDM complex, it is associated with an identification that 
it utilizes during system operation but which is independent of the machine identification. 
This association is done during deadstart, when the machine investigates the 
multimainframe tables residing on the link device and places its machine identification in 
an empty slot of the seven that are available. Associated with each slot is a unique machine 
index and a unique machine mask, which the machine uses either to index itself into 
various MMF tables or to identify itself in these tables. 

When performing a level recovery deadstart on one of the machines, the MREC utility 
should be run on some or all of the remaining machines before the deadstart proceeds. The 
purpose of this utility is to clear interlocks held by the machine to be deadstarted that have 
not been cleared by CPUMTR. It can also recover mass storage space on a shared device 
that is currently not accessible because of a machine interruption (necessitating a level 
deadstart). MREC may have to be run from more than one machine since it affects only 
shared devices (that is, devices specified on the SHARE EQPDECK entry) of the machine on 
which MREC is run. If the interrupted machine shares different devices with different 
machines, MREC must be run from enough machines to account for all devices shared with 
the interrupted machine. The interface to the MREC utility is described in section 8, 
K-Display Utilities. 

If a level 3 recovery deadstart will be performed, extended memory must be intact as well 
as CMR. For a level 1 or 2 recovery in a linked SDM environment, extended memory must 
be intact. 

Figure 13-1 illustrates the steps generally needed to deadstart a machine in a 
multimainframe complex. 
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Figure 13-1. Deadstarting a Machine in a Multimainframe Complex 
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Shared Mass Storage 

A major reason for operating a multimainframe complex is to be able to share mass storage 
devices between machines. Thus, the users of two systems may be able to utilize the same 
files if these files reside on a shared mass storage device. Having the ability to share files 
between systems also means that several additional procedures are required when 
operating a multimainframe complex. Additional consideration must also be given when 
configuring mass storage devices. This material, which is unique to multimainframe 
operation, is discussed in the following paragraphs. 



Configuring Shared Mass Storage Devices 

Some consideration should be given as to which devices should be made shared devices and 
which ones should not. Since a shared device contains preserved files that can be accessed 
by more than one machine, it must be physically connected to and logically defined (as 
shared) by each machine sharing the device. If one device of a family is defined as shared, 
then normally all devices in the family should be defined as shared for accessibility. If a 
removable device will be treated as shared, it must be defined as removable in each 
machine sharing it. If a shared device is not removable, additional use of the device (beyond 
preserved files) is defined by each machine, independently of any other machine definition 
(that is, each machine specifies whether the device is to contain such things as a copy of the 
system or temporary files). 

There is no real advantage to having nonpreserved files on a shared device, unless 
spreading them across shared devices outweighs having them on a dedicated device. A key 
factor is drive and controller contention. Another factor is whether or not enough drives and 
accesses to those drives are available to warrant spreading temporary files across several 
devices from all systems. Also, additional overhead is incurred by the system for each 
shared device. This includes additional CME space for each device (100 8 CM words) and 
additional time that is required to maintain the device-related tables (such as the MST or 
the TRT) on the link device. These factors must be weighed to determine how best to 
configure shared devices. 



Device Access Tables 

In a linked SDM complex, mainframes use DATs to determine device usage. The DATs 
identify the status of all shared and nonshared devices for the mainframes in the complex. 
One DAT is allocated in extended memory for each mass storage device. 

In order to minimize configuration problems, shared removable equipment should be 
configured the same way on all machines in the complex. For example, if one system defines 
three shared units as three single-unit devices and another system defines the same units 
as one three-unit device, the first system can accommodate a two-unit device on these units, 
whereas the second system would consider it an error. Unless the configurations are the 
same on all machines, any devices mounted on those drives may not necessarily be 
recoverable on all machines. 

NOTE 

RESEX considers only the configuration of the machine on which it is executing in its 
overcommitment algorithm. 
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Mass Storage Recovery Tables 

One problem that is created by having more than one machine sharing a mass storage 
device is that of recovering the mass storage space and interlocks of a machine, if it requires 
recovery processing. This problem is solved by defining a table that provides the information 
needed to recover the mass storage space of a machine and by having a machine recovery 
utility that performs the recovery. The table is called the mass storage recovery table (MRT). 
There is one MRT for each mainframe per device. It tells which tracks are interlocked and 
which tracks are first tracks of files local to a particular machine. The MRT is utilized by 
CPUMTR on another machine to clear track interlocks and by the MREC utility on another 
machine to recover the mass storage space of the interrupted machine. For specific 
information on the MRT, refer to the NOS Version 2 Systems Programmer's Instant. 

Shared Buffered Devices 

When performing I/O on a buffered device (for example, on a DAS device), the system uses a 
set of I/O buffers which are maintained in the UEM portion of central memory for the 
mainframe in question. Each of these buffers corresponds to a physical location on the disk, 
and the buffers are effectively used as a cache for the disk. 

When a buffered device is configured as a shared device, the system must prevent the 
condition where two or more mainframes each have an I/O buffer which points to the same 
physical sector on the disk, but the contents of the two buffers are different. This problem is 
avoided by the use of the buffer access table (BAT). One BAT is allocated in extended 
memory for each shared buffered device. 

The BAT is used to grant access permission for a given mainframe to access a given logical 
track in either read or write mode. While two or more mainframes can each have read access 
permission for the same track at the same time, only one mainframe can have write access 
permission for a track, and that write permission also locks out read access permission. 

If one mainframe wants to obtain a BAT access permission that is not currently available 
(because another mainframe currently holds a conflicting BAT access permission), the first 
mainframe posts a request in the buffer request table (BRT). The second mainframe sees 
this request and releases the conflicting access as soon as possible. One BRT is allocated in 
extended memory for each mainframe. 

In addition, due to the way error processing is performed on DAS devices, it is necessary to 
prevent more than one mainframe from performing error processing on the same shared 
DAS device at the same time. This interlocking is accomplished by the use of the buffered 
device table (BDT). One BDT is allocated in extended memory for each shared buffered 
device. 
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Device Initialization 

To initialize a mass storage device, it is necessary first to prevent any new activity from 
starting up on the device, then to wait until all current activity has completed, and finally 
to interlock the device and proceed with initialization. To accomplish this on shared mass 
storage devices in a linked SDM environment, follow these steps: 

1. Enter the DSD UNLOAD command. All machines sharing the device must unload it to 
prevent any new activity. (This command can be used for both removable and 
nonremovable shared devices.) 

2. Enter the DSD INITIALIZE command on the machine from which the initialization is 
to take place. If you enter the INITIALIZE command from another machine, an error 
message is displayed. Refer to the NOS Version 2 Operations Handbook for error 
messages. 

3. The machine from which the INITIALIZE command was entered monitors the status of 
the other machines that are sharing the device. Once they have unloaded the device and 
user activity has ceased, the device tables are updated and the device is checkpointed. 

4. To activate the device on the other machines, enter the DSD MOUNT command from 
each machine. This command clears the UNLOAD status. If initialization is still in 
progress on another machine when you enter a MOUNT command, the MOUNT process 
is terminated with an error. Refer to the NOS Version 2 Operations Handbook for error 
messages. 
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Device Unload 

In a linked SDM environment, unloading a device involves more than it does under a 
one-machine system. A device can be unloaded from a machine (referred to as a local 
unload), or it can be unloaded from the entire multimainframe complex (referred to as a 
global unload). A device can be physically removed from the complex only after a global 
unload has been accomplished. This is the general procedure to complete a global unload: 

1. Enter the UNLOAD command from each machine. This is an indication to the machine 
that no new accesses should be initiated. You must enter this command from each 
machine sharing the device. 

2. When all local unloads are set and user access has ceased, global unload status is set if 
the device is a removable device. This global unload status is displayed on all machines, 
indicating that there is no activity on the device from any machine and that the device 
may be physically unloaded. 

3. You can then switch packs and enter the MOUNT command at the console to initiate 
recovery of the device. The MOUNT command clears the global unload status and the 
local unload status on the machine from which it was entered and indicates that this 
machine is now accessing the device. All other machines continue to ignore the device 
until you enter the MOUNT command on each machine. The MOUNT command does 
nothing if local unload status is not set on the machine. 

Device Recovery 

Deadstart and online recovery methods are similar in logic for recovering mass storage 
devices. 

When a device is recovered in a linked SDM complex, the DAT in extended memory is 
interlocked while a check is made to see if an entry exists for this device. The presence of 
an entry indicates that another machine is also accessing the device. If an entry is found 
and the machine recovering the device has not been instructed to share it, an error is 
indicated and recovery halts with an appropriate message displayed. If the machine already 
accessing the device is not allowing it to be shared, the same error condition occurs. 
Therefore, if a device is being accessed, another machine can recover that device only if the 
recovering machine and the accessing machine use the device in a multimainframe mode. 



NOTE 



If two devices recovered on separate machines have the same family name/device number or 
pack name, there is no method of determining whether or not they are the same device if 
both are shared. If they are different devices, they are both destroyed when used. 
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Device Checkpoint 

Local MST information for each machine that shares a mass storage device is maintained 
on the device. MST information for other machines may also be present on the device. The 
information for each machine is kept in one sector on the label track following the TRT 
sectors. Entries for up to 31 unique machine identifiers can exist. 

During checkpoint, only the local MST information of the machine performing the 
checkpoint is updated. Since local MST information for many machines is kept on the 
device, updating of all these areas by one machine could cause a loss of information needed 
if the device were to be used with another system. 

For shared devices in a linked SDM complex, duplication of checkpointing by more than one 
machine is prevented. If a machine attempts to checkpoint a shared device and determines 
that a second machine is performing the checkpoint (a checkpoint request bit is set in the 
local MST area of the second machine), no action is taken. Only one checkpoint bit is set at 
any given time for a device. 

MSE Processing 

Unlike most other mass storage devices, the 7990 is not shared by mainframes. Rather, 
7990 is physically connected to and driven by one mainframe called the master mainframe. 
All other mainframes that share permanent files with the master mainframe are called 
slave mainframes. The disks to which 7990-resident files are staged must be shared devices 
and accessible by all mainframes. 

SSEXEC runs on the master mainframe and is the main program that controls MSE 
processing activities. You can activate SSEXEC by entering the following DSD commands 
at the system console. 

L . SUBSYST . 

ENABLE, MASTER MSE. 

L.EKD. 

MSEffff . 

SSSLV runs on each slave mainframe and is the program that supports file retrieval from a 
7990 for jobs running on a slave mainframe. You can activate SSSLV by entering the 
following DSD commands at the system console. 

L . SUBSYST . 

DISABLE, MASTER MSE. 

L.END. 

MSEffff. 

When a job running on a slave mainframe attaches a 7990-resident file that has no disk 
image, SSSLV is requested to stage the file to disk. However, SSSLV cannot access 7990 
directly. SSSLV must communicate with SSEXEC, which stages the file to a shared disk 
and then notifies SSSLV when the file is available. SSSLV then causes the requesting job to 
be resumed so that the file ATTACH can complete. 

The permanent files used for communication between SSEXEC and SSSLV are initialized 
and recovered automatically and require no backup or recovery processing. The name of the 
permanent file used by SSSLV running on mainframe i (i=l, 2, 3, 4) to send requests to 
SSEXEC is STBMNOi. The name of the permanent file used by SSEXEC to respond to all 
requests by all SSSLVs is MTBSPFN. These files belong to the family that contains 
extended memory and are saved under the user index 377760 8 . 
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Independent SDM Operation 

In an independent SDM complex, up to 16 computers can access shared mass storage 
devices. Any combination of from 1 to 16 model 71, 72, 73, 74, 171, 172, 173, 174, 175, 176, 
720, 730, 740, 750, 760, 865, 875, CYBER 180-class machines, or 6000 Computer Systems 
mainframes can be used. Shared mass storage devices supported are 834, 836, 844 (single 
and double density) and 885-11/12 (single and double density). 

Each shared device contains in its label track all of the tables necessary to control 
multimainframe access. These tables include the MST, TRT, device index table (DIT), and 
MRT for each mainframe sharing the device. Whenever a mainframe needs to access a 
shared device, it is necessary for the mainframe to ensure its copies of these tables are 
up-to-date. 

One or more of the mainframes can have extended memory, but each mainframe's extended 
memory must be used as a nonshared device. 

If MSE is used, one mainframe in the independent SDM complex is physically connected to 
7990 and only that mainframe can access it. 



Deadstart 

An independent SDM environment is defined at deadstart by CMRDECK and EQPDECK 
entries in each machine. Use the following entries to do this. 



CMRDECK Entry 



MID=id. 



Description 



2-character machine identification. This 
identification is used to associate a specific machine 
with its access to a shared device. It is required, 
however, even if no devices are shared during system 
operation. This id must be unique for each machine 
in the complex. If id is omitted, the default value is 
MID=AA 



EQPDECK Entry 



ISHARE=est 1 ,est 2 ,.-.,est n . 



PRESET=est 1 ,est 2 ,...,est n . 



Description 



EST ordinals of the mass storage devices that will be 
independently shared with other machines in the 
multimainframe complex. The ISHARE entry must precede 
the PRESET entry. The MST/TRT resides on each shared 
device. 

EST ordinal of the shared mass storage device to be preset. 
You can specify this entry only at the system console. 
Several machines at level deadstart may need the 
PRESET entry. The PRESET entry is specified only on a 
level deadstart by the first machine accessing the device 
and must follow the ISHARE entry. PRESET initializes the 
tables residing on the label track of the shared devices. 



These entries are also described in section 3, Deadstart Decks. 
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Since in an independent SDM complex two or more machines can utilize the same mass 
storage devices, the device assignments and EQPDECKs of all machines are interrelated. 
Care must be taken to ensure proper EQPDECK settings for each machine to obtain the 
desired device configuration. The following items are important in obtaining this proper 
device configuration. 

• Each machine must specify a unique machine identification (using the MID entry in the 
CMKDECK). This identification associates a particular machine with its files on a 
shared device. There are no external characteristics associated with this identification. 
However, if the machine identification specified on a machine deadstarting into a 
multimainframe complex is identical to a machine identification on a machine already 
operating, the deadstart process halts and an appropriate message is displayed. 

• The assignment of shared mass storage devices should be made properly to ensure the 
recoverability of the device and the proper operation of the system (refer to Shared 
Mass Storage, next). 

• Each machine must specify the ISHARE=est EQPDECK entry to inform the system 
that devices will be shared in the independent shared device mode. 

• If you need to deadstart an interrupted mainframe in an independent SDM 
environment, you should put the nonfailing mainframes in STEP mode before 
deadstarting the interrupted mainframe. 

• On a level deadstart, any shared device that has not been shared prior to this 
deadstart must include the PRESET entry in its definition. 

• On a level deadstart, if a device was previously shared by the deadstarting machine, 
the MRT and DIT device resident tables must be zeroed out. 

- If the machines that share the device are not currently running, the device must be 
preset or initialized to zero out the tables. 

- If any machine that shares the device is running, the machine recovery utility 
(MREC) must be run from a running machine to remove the machine identification 
of any machines that are not currently running and to clear all interlocks held by 
these machines. 

• On a level deadstart, if a device was previously shared by a machine other than the 
deadstarting machine, the MRT and DIT device resident tables may or may not have to 
be zeroed out. 

- If another machine that is sharing the device is running, the device must not be 
preset. 

- If no machines that will be sharing the device are running and one or more of them 
will be deadstarted at a level 1, 2, or 3, the device must not be preset. 

- If all machines that will be sharing the device are not currently running and all 
will be deadstarted at level 0, the device can be preset or initialized. 
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When performing a level recovery deadstart on one of the machines, the MREC utility 
should be run on some or all of the remaining machines before the deadstart proceeds. The 
purpose of this utility is to clear interlocks held by the machine to be deadstarted that have 
not been cleared by CPUMTR. It can also recover mass storage space on a shared device 
that is currently not accessible because of a machine interruption (necessitating a level 
deadstart). MREC may have to be run from more than one machine since it affects only 
shared devices (that is, devices specified on the ISHARE EQPDECK entry) of the machine 
on which MREC is run. If the interrupted machine shares different devices with different 
machines, MREC must be run from enough machines to account for all devices shared with 
the interrupted machine. The interface to the MREC utility is described in section 8, 
K-Display Utilities. 

In an independent SDM complex, as in a standalone system, critical tables that reside on 
the device must be intact for a level 1, 2, or 3 deadstart recovery. 

Figure 13-1 illustrates the steps generally needed to deadstart a machine in a 
multimainframe complex. 

Shared Mass Storage 

A major reason for operating a mmtimainframe complex is to be able to share mass storage 
devices between machines. Thus, the users of two systems may be able to utilize the same 
files if these files reside on a shared mass storage device. Having the ability to share files 
between systems also means that several additional procedures are required when 
operating a multimainframe complex. Additional consideration must also be given when 
configuring mass storage devices. This material, which is unique to multimainframe 
operation, is discussed next. 
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Configuring Shared Mass Storage Devices 

Some consideration should be given as to which devices should be made shared devices and 
which ones should not. Since a shared device contains preserved files that can be accessed 
by more than one machine, it must be physically connected to and logically defined (as 
shared) by each machine sharing the device. If one device of a family is defined as shared, 
then normally all devices in the family should be denned as shared for accessibility. If a 
removable device will be treated as shared, it must be defined as removable in each 
machine sharing it. If a shared device is not removable, additional use of the device (beyond 
preserved files) is defined by each machine, independently of any other machine definition 
(that is, each machine specifies whether the device is to contain such things as a copy of the 
system or temporary files). 

There is no real advantage to having nonpreserved files on a shared device, unless 
spreading them across shared devices outweighs having them on a dedicated device. A key 
factor is drive and controller contention. Another factor is whether or not enough drives and 
accesses to those drives are available to warrant spreading temporary files across several 
devices from all systems. Also, additional overhead is incurred by the system for each 
shared device. This includes additional CMR space for each device (100 8 CM words) and 
additional time that is required to maintain the device-related tables (such as the MST or 
the TRT) on the link device. These factors must be weighed to determine how best to 
configure shared devices. 

In an independent SDM complex, where device-related tables are maintained on the device 
itself, system performance degradation can occur if the shared devices are not properly 
configured. Since the device must be accessed every time its tables in CMR are not up to 
date, drive and controller contention is increased and system performance is affected. To 
reduce the impact on system performance you can: 

• Put the system and temporary files on nonshared devices. 

• Put only those fast-attach files that must be global on shared devices. 

• Use multiple channels and multiple controllers to improve performance and provide 
additional paths to shared devices. 
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Device Index Tables 

In an independent SDM complex, mainframes use DITs to determine device usage. The 
DITs contain the MIDs of the mainframes that can access the shared device. The shared 
device maintains a DIT for each mainframe that shares it. The DITs reside on each shared 
device within the MST on the device's label track. 

Mass Storage Recovery Tables 

One problem that is created by having more than one machine sharing a mass storage 
device is that of recovering the mass storage space and interlocks of a machine, if it requires 
recovery processing. This problem is solved by defining a table that provides the 
information needed to recover the mass storage space of a machine and by having a 
machine recovery utility that performs the recovery. The table is called the MET. There is 
one MRT for each mainframe per device. It tells which tracks are interlocked and which 
tracks are first tracks of files local to a particular machine. The MRT is utilized by 
CPUMTR on another machine to clear track interlocks and by the MREC utility on another 
machine to recover the mass storage space of the interrupted machine. For specific 
information on the MRT, refer to the NOS Version 2 Systems Programmer's Instant. 

Device Initialization 

To initialize a mass storage device, it is necessary first to prevent any new activity from 
starting up on the device, then to wait until all current activity has completed, and finally 
to interlock the device and proceed with initialization. To accomplish this on shared mass 
storage devices in an independent SDM environment, follow these steps: 

1. Enter the DSD UNLOAD command. All machines sharing the device must unload it to 
prevent any new activity. (This command can be used for both removable and 
nonremovable shared devices.) 

2. Enter the DSD INITIALIZE command on the machine from which the initialization is 
to take place. Each entry of the INITIALIZE command toggles INITIALIZE on and off. 
If two machines in the complex enter the INITIALIZE command, the INITIALIZE 
command is toggled off and no error message is displayed. 

3. The machine from which the INITIALIZE command was entered monitors the status of 
the other machines that are sharing the device. Once they have unloaded the device 
and user activity has ceased, the device tables are updated. 

4. To activate the device on the other machines, enter the DSD MOUNT command from 
each machine. This command clears the UNLOAD status. If initialization is still in 
progress on another machine when you enter a MOUNT command, the machine waits 
for INITIALIZE to finish and then continues with the MOUNT process. 



60459300 U Multunainframe Operations 13-15 



Independent SDM Operation 



Device Unload 

In an independent SDM environment, unloading a device involves more than it does under 
a one-machine system. A device can be unloaded from a machine (referred to as a local 
unload), or it can be unloaded from the entire multimainframe complex (referred to as a 
global unload). A device can be physically removed from the complex only after a global 
unload has been accomplished. This is the general procedure to complete a global unload: 

1. Enter the UNLOAD command from each machine. This is an indication to the machine 
that no new accesses should be initiated. You must enter this command from each 
machine sharing the device. 

2. When all local unloads are set and user access has ceased, global unload status is set if 
the device is a removable device. This global unload status is displayed on all machines, 
indicating that there is no activity on the device from any machine and that the device 
may be physically unloaded. 

3. You can then switch packs and enter the MOUNT command at the console to initiate 
recovery of the device. The MOUNT command clears the global unload status and the 
local unload status on the machine from which it was entered and indicates that this 
machine is now accessing the device. All other machines continue to ignore the device 
until you enter the MOUNT command on each machine. The MOUNT command does 
nothing if local unload status is not set on the machine. 

4. A pack that has not been previously mounted in this system must be preset with a 
MOUNT,est,P command. 

Device Recovery 

Deadstart and online recovery methods are similar in logic for recovering mass storage 
devices. 

For a machine to recover a device in an independent SDM complex, the MID of the machine 
must be in the device's DIT. If the MID is not in the DIT, an error message is issued and 
recovery is impossible. When recovering a device in a standalone environment, the device is 
not checked if it is/was an independent shared device. 
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Device Checkpoint 

Local MST information for each machine that shares a mass storage device is maintained 
on the device. MST information for other machines may also be present on the device. The 
information for each machine is kept in one sector on the label track following the TRT 
sectors. Entries for up to 31 unique machine identifiers can exist. 

During checkpoint, only the local MST information of the machine performing the 
checkpoint is updated. Since local MST information for many machines is kept on the 
device, updating of all these areas by one machine could cause a loss of information needed 
if the device were to be used with another system. 

In an independent SDM complex, the MST and TRT information is maintained on the 
device. If the MST and/or TRT information changes during a device access, the system 
updates the MST and/or TRT information making it unnecessary for the system to 
periodically checkpoint the device. 

MSE Processing 

Unlike most other mass storage devices, the 7990 is not shared by mainframes. Rather, 
7990 is physically connected to and driven by one mainframe. The only machine that can 
access the 7990-resident files is the physically connected independent SDM. MSE processing 
is the same in an independent SDM environment as it is in a single mainframe 
environment. Refer to section 11, Mass Storage Extended Subsystem. 
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This section describes utilities that are used to maintain network access devices (NADs). 

Dump NAD Memory (DMPNAD) 

DMPNAD is a utility program that uses data obtained either directly from NAD memory or 
from a binary dump file (produced previously by MHF or DMPNAD) to generate a print file 
showing each NAD word in both hexadecimal and 7-bit ASCII code. 

The format of the DMPNAD command is: 

DMPNAD, p-L , p 2 , . . . , p n - 

P- is a parameter consisting of a keyword or a keyword equated to a value. All parameters 
are order independent. 

Pj Description 



AC=aaaa The 4-digit hexadecimal number specifying the remote NAD's access code 

(refer to the RHF K display in section 8, K-Display Utilities). The default is 
AC=0000. 

B=binfile The 1- to 7-character name of the file on which the binary output is to be 
written. The default is no binary output file. 

B Same as B=BINOUT. 

CH=ch The 1- or 2-digit octal number specifying the channel number of the local 

NAD (denned in the NAD's EST entry). 

I=infile The 1- to 7-character name of the file containing binary input data. 

DMPNAD dumps only one record from the file. The default is no binary 
input file. 

I Same as I=BININ. 

L=outfile The 1- to 7-character name of the file on which the list output is to be 
written. The default is L=OUTPUT. 

LT^t^^ The 4-digit binary bit pattern specifying the TCUs that connect a local NAD 
to a remote NAD. t,j=l enables TCU n . For example, LT=1100 indicates that 
local TCUs and 1 are enabled. 

ND=nn The 2-digit hexadecimal number specifying the remote NAD's address (refer 

to the RHF K display in section 8, K-Display Utilities). 
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The DMPNAD utility can be called from the console or a batch job. The calling job must be 
of system origin or you must be validated for system origin privileges. You normally include 
the channel number on the DMPNAD command to specify which local NAD is to be dumped. 
The dump can also be saved as a binary output file (B parameter) which can be listed later. 

DMPNAD can dump either a local NAD (380-170 NAD connected to the host mainframe 
using a channel and configured in the EST) or a remote NAD (any 380 NAD accessible to a 
local NAD using a loosely-coupled network trunk). For a local NAD dump, the EST entry 
associated with the local NAD's channel number must be OFF or the controlware-not-loaded 
flag must be set. Since the local NAD dumping process stops all NAD activity, the NAD 
controlware must be reloaded using LOADBC (refer to section 1, Controlware Utilities) 
before the local NAD can be used by the operating system. 

Remote NAD dumping is selected by specifying the remote NAD to be dumped (AC and ND 
parameters), the local NAD's channel number used to access the remote NAD (CH 
parameter), and the TCU used to connect the local NAD to the remote NAD (LT parameter). 
For remote NAD dumping, the local NAD must be loaded and running and its EST entry 
must be ON. 

Remote NAD dumping operations can occur concurrently with RHF use of the local NAD. 
However, extreme care should be exercised when performing a remote NAD dump to ensure 
that the correct remote NAD is being dumped and that the remote NAD is not being used 
by the mainframe to which it is connected. After the remote NAD dumping operation, the 
NAD controlware must be reloaded into the remote NAD before it can be used by the 
remote mainframe. 

When the I parameter is specified, DMPNAD will list a binary file that was saved earlier. 
Since no NAD access is required, no special privileges are required by the calling job. 



Maintenance Host Facility (MHF) 

MHF is a utility program that executes while RHF is active. MHF periodically copies NAD 
error logs to the binary maintenance log, loads microcode into local NADs during RHF 
initiation, and dumps and reloads local NADs that fail. MHF uses a copy of the network 
description table obtained directly from RHF to determine which NADs to log, dump, and/or 
load. 

You control MHF operation by setting the AUTOLOAD, AUTODUMP, TRACE, and LOG 
parameters in the LNAD and RNAD directives for RCFGEN, which generates the RHF 
configuration file (refer to section 10, LID/RHF Configuration Files). You can control the 
remote NAD LOG parameter on RHFs network path table display (refer to section 8, 
K-Display Utilities). If you specify AUTODUMP=YES for local NADs, MHF saves NAD 
memory dumps as labelled binary records on permanent file NDFMid (id is the host 
mainframe identifier) under user name SYSTEMX. Each record label contains the record 
name NDMPLch (ch is the NAD's channel number), record number, and the date and time 
of the dump. MHF puts this dump information in the following sequence of job dayfile 
messages: 

MHF, NAD DUMP RECORD NAME = NDMPLch 
MHF, RECORD NO.OOOO TIME = hh.mm.ss 
MHF, FILE = NDFMid DATE = yy/mm/dd 

When loading a local NAD, MHF obtains the controlware from the system and uses a default 
set of controlware initialization parameters that it adjusts to suit the NAD's memory size. 
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Listing NAD Dumps 

To list a NAD dump, you must be validated to obtain access to the NAD dump permanent 
file NDFMid (id is the host mainframe identifier). 

You can either use ITEMIZE to locate a particular record on permanent file NDFMid or 
obtain the record number from MHFs dayfile, and then use DMPNAD to list the dump 
record. (ITEMIZE shows the record name, record number, date, and time corresponding to 
MHFs dayfile messages.) 

The following example lists dump record 4 of permanent file NDFM64: 

ATTACH , NDFM6 4 / UN=SYSTEMX . 

itemi ze , ndfm6 4 . Check ITEMIZE output for the record number. 

skipr, NDFM64 , 3 . Skip to the fourth record. 

dmpnad , i=ndfm64 , l=list . List the fourth record on file LIST. 

RETURN, NDFM6 4. 
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The commands described in this section are used when the network access method (NAM) is 
being initialized or is active. They initialize and control the network processing units 
(NPUs), device interfaces (DIs), trunks, lines, terminals, and application programs under 
network supervision. 

NAM supports two types of networks: the 255x NPU network and the CDCNET network. 
Throughout this section, the term network refers to the 255x NPU network. However, 
whenever a statement is applicable to both network types, both types are named explicitly. 

NAM controls the CDCNET network by sending commands to an application called 
Network Operator Utility (NETOU). This NAM application is also known as the network 
operations server. For further information on controlling the CDCNET network, refer to the 
CDCNET Network Operations Manual and the CDCNET Network Analysis Manual. 

Network Organization 

Initiating NAM (refer to the DSD NAM command in section 5, DSD Commands) causes 
NAM, and the communications supervisor (CS), network supervisor (NS), network 
validation facility (NVF), and terminal verification facility (TVF) to be loaded and initiated 
at control points. Refer to the NAM/CCP 3 Terminal Interfaces Reference Manual for more 
information on TVF. CS provides control and status of the NPUs and all of their 
communication lines and terminals. NS loads and dumps all of the NPUs in the 
communication network. NVF validates terminal users and applications as they attempt to 
access the network. 

Multiple hosts may belong to the network. Hosts may assume one or more supervisory roles 
in the network. Each host will have a copy of NVF that will validate users connecting to 
and applications executing in that host. NVF provides these services for both the 255x NPU 
network and the CDCNET network. The supervisors CS and NS may execute in any or all 
of the CYBER hosts. Whenever an NPU needs to be loaded, it may request any copy of NS 
to perform the load (not always the same copy). Once an NPU is running, it may request 
any copy of CS to supervise it. Each NPU will have a preferred copy of CS, but it may 
request supervision from an alternate copy of CS if its preferred CS is not available. In any 
case, the network is always capable of functioning without any one or more of its hosts. 
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Whenever a CDCNET mainframe device interface (MDI) or mainframe terminal interface 
(MTI) must be loaded, it requests the services of a CDCNET job called INITMDI, which is 
responsible for loading and dumping the MDIs and MTIs. NAM automatically starts 
INITMDI upon demand. 

Whenever a terminal device interface (TDI) or a network device interface (NDI) must be 
loaded, the MDI helping in the load process establishes a connection through NAM to the 
NAM application called the Network File Server (NETFS), which controls the loading and 
dumping of TDIs and NDIs. 

The 255x NPU network consists of channels, couplers, lines, logical links, NPUs, terminals, 
and trunks (refer to figure 15-1) connected to the host computer. 

• A channel is a data path on which a peripheral device controller can be accessed. 

• A coupler is a hardware element that links an NPU to a channel. 

• A line is the circuit that connects a terminal to an NPU. 

• A logical link is a logical path connecting a coupler and an NPU or two couplers. 

• An NPU is the communications controller that transmits data between terminals and a 
host computer or between two host computers. 

• A public data network is an X.25 packet switching network (PSN). Terminals, NPUs, 
and foreign hosts can be connected to a PSN to exchange data. 

• A terminal is a device by which a user supplies input messages to, and accepts output 
messages from, an application program. 

• A trunk is the communication line connecting two NPUs. 

The CDCNET network consists of channels, couplers, lines, logical links, device interfaces 
(MDIs/MTIs/NDIs/TDIs), terminals, and trunks. For definitions of CDCNET terminology, 
refer to the CDCNET Conceptual Overview Manual. 
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Figure 15-1. Sample 255x NPU Network 
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Network host products (NHP) is the network software residing on the CYBER host. NHP 
recognizes four types of network operators: the host operator, the NPU operator, the 
diagnostic operator, and the CDCNET operator. A host operator (HOP) resides at the 
system console, initiates NAM, and can control 255x NPU network and CDCNET network 
elements being supervised by this host. An NPU operator (NOP) resides at a terminal and 
controls 255x NPU network elements (such as lines, logical links, NPUs, terminals, and 
trunks). A diagnostic operator (DOP) resides at a terminal and monitors and tests 
communication lines on the 255x NPU network. 

A CDCNET operator (COP) resides at either the system console or a terminal and controls 
CDCNET network elements (such as lines, terminals, trunks, and DIs associated with 
CDCNET). 

The HOP can always perform COP, NOP, and DOP functions regardless of the existence of 
COPs, NOPs, and DOPs. NOPs can perform all DOP functions regardless of the existence of 
DOPs. CS supports up to 10 concurrent NOP and DOP connections in addition to one HOP 
connection. NS and NVF support only the HOP connection. 

The HOP can communicate with NAM and any of the supervisors (CS, NS, NETOU, or 
NVF) executing in its host. COPs can communicate only with NETOU. Refer to the 
CDCNET Network Operations Manual for additional information. NOPs and DOPs can 
communicate with any CS executing in any host to which the operator has access. However, 
a NOP or DOP can communicate with only one CS at a time. A NOP or DOP can monitor 
and control only those elements owned by NPUs being supervised by their CS. 

Each NPU in the network is controlled by the HOP and, optionally, one NOP connected to 
its supervising CS. A HOP controls all NPUs supervised by CS. Each NOP connected to CS 
can control one or more NPUs. 
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NAM Startup 

If the NPUs in the network were running version 3.5 or earlier Communications Control 
Program (CCP), you must master clear all local NPUs before initiating NAM. If the NPUs 
were running version 3.6 or 3.7 of CCP, then master clear NPUs only if the running version 
is not the desired version. 

You initiate NAM by entering: 

NAM. 

or 

NAMNOGO . 

NAM 1 and NAMNOGO are names of procedure files that are called when the HOP initiates 

NAM. 

The first time the network is initiated the NAMNOGO procedure must be used to create a 
memory file (refer to the NOS Version 2 Installation Handbook). The memory file contains 
the name of the master file, the last parameter record, and the network invocation number 
(NIN) used. The NIN is incremented by 1 every time NAM is started. The NIN is displayed 
in the NAM K display. If the network has been previously initiated, a memory file exists 
and the NAM procedure file may be used. 

Initiating NAM Without Operator Intervention 

If you initiate NAM by entering 

NAM. 

NAM 2 is brought up without further operator action. This results in starting the network 
using the previously specified master file and the parameter record RESTRT. 



1. Any procedure file of the form NAMffff is allowed. 

2. Any procedure file of the form NAMffff is allowed. 
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Altering the Memory File 

If you initiate NAM by entering 

KAMNOGO . 

NAM displays the message: 

ENTER DESIRED OPTION 

You reply to this message with a CFO command in this format: 

CFO,NAM.p 1( p 2 , . ..p n . 

Pj is a parameter consisting of a keyword equated to a value. All parameters are order 
independent. 



Pi 



Description 



MFN=filename 



UN=usemame 



PW=password 



Permanent file name of the master file to be used. The master file 
contains all the information needed to initiate the network. Once 
this parameter is specified all subsequent network initiations use 
this master file until a new master file is specified. The master file 
resides in the system default family and must be permitted to 
SYSTEMX. If this parameter is not specified, NAMSTRT is 
assumed. Refer to NAM Procedure File in the NOS Version 2 
Installation Handbook for further information about file NAMSTRT. 

User name for the master file. If this parameter is not specified, 
NETOPS is assumed. 

Password associated with the master file user name. 
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p. Description 

RN=recordname 3 Name of the parameter record on the master file that is used for 
this network initiation. If this parameter is not specified, the 
previously specified parameter record is used. The parameter record 
specifies the characteristics of any particular network initiation. 

You can select one of the parameter record names listed in 
table 15-1 to obtain the given combination of features. 

OIN=xx Previous network invocation number. All network dump and trace 

files with a network invocation number less than or equal to the 
value specified by the OIN parameter are collected. If this 
parameter is not specified, the current network invocation number 
minus 1 is used. 

You can enter all desired parameters with a single entry or enter several CFO commands. 
In this way you add (if the file is empty) or replace entries in the NAM memory file. 

When you have finished adding or replacing data, enter the command: 

CFO, NAM. GO. 

After entering this command, you cannot add or replace additional parameters during this 
NAM initiation. 

Table 15-1. Parameter Record Feature Descriptions 



Feature Descriptions 


INIT RESTRT 


RECOVR 


MULTI 


MINIT 


MRECOV 


This feature collects 
dumps/traces on tape before 
startup. 3 


Nl 


Y 2 


N 


Y 


N 


N 


This feature stops local NPUs 
at startup. 


Y 


N 


N 


N 


Y 


N 


This feature stops local NPUs 
upon abnormal NHP 
termination. 


Y 


Y 


N 


N 


N 


N 


This feature takes NPU 
dumps before initial load. 4 


N 


Y 


N 


Y 


N 


N 



1. N indicates that the parameter record name causes the action not to occur. 

2. Y indicates that the parameter record name causes the action to occur. 

3. Dumps/traces are collected for NHP, 255x NPU, and CDCNET whenever present. 

4. This feature has no effect on MDIs and MTIs. 



3. Specifying a record name changes recordname only for this initiation. 
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NAM Shutdown 

NAM is idled by assigning the K display to the application NVF, followed by entering the 
DISABLE,HOST or IDLE,HOST command. 

The sequence of commands is: 

K.AP=NVF. 

K. DISABLE, HOST. 

or 

K. IDLE, HOST. 

Use the IDLE command for a graceful shutdown, and the DISABLE command for an 
immediate shutdown. 
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Network Control by HOP 

The commands described next are available only to the HOP. The HOP can perform all 
functions of the NPU operator, CDCNET operator, and diagnostic operator as well as those 
unique to the HOP. The commands unique to the HOP are processed by NS and NVF. 

Disabling and Enabling of Couplers 

The HOP enables either an NPU or MDI/MTI coupler using the DSD ON command and 
disables the coupler using the DSD OFF command. You can examine the NP equipment 
entry on the E ,A display to determine the EST ordinal. When an active coupler is turned 
OFF, NAM stops communicating with that coupler. The coupler is not used again until it is 
turned ON while NAM is executing. When a coupler is turned ON, NAM automatically 
begins to communicate with the NPU or MDI/MTI connected across the coupler. 



Status Message Formats for HOP 

The HOP commands cause various status messages to be displayed at the system console. 
The normal response to a STATUS command consists of a single status line for each 
referenced element. 

Following are the general formats for these status messages. 

Message Type Format ^ 

Application status line 
Terminal status line 
User status line 



APPL : name , status , conncount , mxcopies , j sn , restart . 
TERM: name,username,hh.mm.ss / applname/acn,ah.am.as,dt. 
USER: name, termname,hh.nim.ss,applname/acn,ah.am.as,dt. 



In the preceding status message general formats the following variables are used. 
Variable Description 



acn 

ah.am.as 

applname 

conncount 

dt 

hh.mm.ss 

jsn 

mxcopies 



Connection number for the connected application. 

Time of the connection to the application (hours, minutes, and seconds). 

Name of the connected application. 

Count of the active connections to this application. 

Device type. 

Time of the system or host login (hours, minutes, and seconds). 

Job sequence name of the application. 

Maximum number of copies of this application that can be running at one 

time. 
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Variable Description 



name Name of the specified element. 

restart If the characters RS are present, they indicate that NVF will automatically 

start up a copy of this application to complete a connection request for it. 

status Status of the application. The application program is initially set to either 

an enabled or disabled state. Enabled application programs become active 
when they start executing. The application program is in one of these states: 



status Description 



AC Application is active (you can establish a connection to the 

application). 

DI Application is disabled. 

DN Application is down (the application failed; NAM tables are being 

cleared up). 

EN Application is enabled. 

termname Name of the terminal at which the user resides, 
username Login user name of the terminal user. 

Unsolicited Status Reports for HOP 

Each time a significant event occurs, CS, NS, or NVF updates its recent history buffer (refer 
to Recent HISTORY Command later in this section) and logs the event in the NAM dayfile. 
CS, NS, or NVF then sends a report about the event, called the unsolicited status report, to 
the HOP. The HOP can get unsolicited status reports from CS, NS, or NVF by assigning the 
NAM K display to that particular application. Refer to section 8, K-Display Utilities, for 
information on how to assign the NAM K display. Unsolicited status reports are 
time-stamped whereas solicited status reports are not time-stamped. 

If an unsolicited status report is important enough to require alerting the operator or 
system analyst, NS, CS, or NVF will display its application name on the alert line of the 
NAM K-display unless the NAM K-display is already assigned to that application. The 
operator or system analyst should then assign the NAM K-display to the application and 
follow the procedures indicated in the NOS Version 2 Operations Handbook for the 
appropriate alert message. 

Refer to the CDCNET Network Operations Manual for NETOtTs treatment of unsolicited 
information for the CDCNET operator. 
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HOP Commands 

The HOP must assign the NAM K display to a supervisory application (CS, NS, or NVF) 
before entering any of the following commands. Refer to section 8, K-Display Utilities, for 
information on how to assign the NAM K display. CS, NS, and NVF support both the right 
and left K-displays. The right K-display provides help information. 

All HOP commands consist of a command verb and, sometimes, one or more parameters. 
The commands must begin in the first character position after K. and contain no blanks. 
The terminator (.) is optional. Some command verbs and parameters can be shortened to a 
2- or 3-character abbreviation. You can mix abbreviated and unabbreviated command verbs 
and parameters in all network commands. Parameters are order independent except where 
noted. 

NS Control Commands 

The HOP assigns the NAM K display to NS to enter the following commands. The NS 
control commands do not apply to the CDCNET network. 

Cancel Alternate NPU Load File Command 

After using a FILE command, the HOP can instruct NS to return to the use of the default 
NPU load file for loading all NPUs by specifying the NOFILE command. 

The command format is: 

NOFILE. 

or 

NO. 
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Change NPU Load File Command 

The HOP can assign an alternate load file to NS for loading a specific NPU with the FILE 
command. 

The command format is: 

FILE , NPU=npuname , NLF=loadf ile , UN=username , PW=password . 

or 

FI , NP=npuname , ML=loadf ile , UN=username , PW=pas sword . 

Parameter Description 

npuname Name of the NPU. 

loadfile Name of the alternate load file loadfile. 

username Username of the user to which file loadfile belongs. 

password Password for the username to which file loadfile belongs. 

The next load of the specified NPU will be from the alternate load file. You can return to 
the default NPU load file by using the NOFILE command. 

NPU Load Status Command 

The HOP can request the current load/dump status of a specific NPU or all NPUs using the 
STATUS command. 

There are two forms of the STATUS command. 

Specific NPU 

The first form requests the current load/dump status of a specific NPU. 

The command format is: 

STATUS , NPU=npuname . 

or 

ST , NP=npuname . 
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AllNPUs 

The second form requests the current load/dump status of all NPUs. 

The command format is: 

STATUS, NPUS. 

or 

ST,NPS. 

Status Response 

The normal status response consists of four lines of information for each NPU, as shown 
below. 



npuname 



Status 



NN=nid NBS=nid,nid,nid,nid,nid,nid EC=errcnt 

LDS=ldcnt LD=yy/mm/dd LT=hh.mm.ss 

dflag dmpfile HALT ffff DD=yy/mm/dd DT=hh.mm.ss 
message 

Description 



npuname 
NN=nid 
NBS=nid,...,nid 
EC=errcnt 

LDS=ldcnt 
LD=yy/mm/dd 

LT=hh.mm.ss 

dflag 



dmpfile 
ffff 



Name of the network processing unit. 

Node number of the NPU identified by npuname. 

Node numbers of up to six neighboring NPUs or couplers. 

Protocol error count. Number of dump/load service messages 
received from the NPU that violated the NPU dump/load protocol. 

Number of attempted loads of this NPU. 

Date in year, month, and day when the most recent load attempt of 
this NPU occurred. 

Time in hours, minutes, and seconds when the most recent load 
attempt of this NPU occurred. 

NPU memory dump indicator; one of the following: 

dflag Description. 

DUMP Dump NPU before a load. 

NODUMP No NPU dump before a load, 
blank NPU is not currently being loaded. 

Name of the most recent NPU dump file. 

Halt code (halt codes are described in the CCP 3 Diagnostic 
Handbook). 
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Status 



Description 



DD=yy/mm/dd 
DT=hh/mm/ss 
message 



Date in year, month, and day when the most recent dump of this 
NPU occurred. 

Time in hours, minutes, and seconds when the most recent dump of 
this NPU occurred. 

Message is the NS activity and its associated status (table 15-2). 



Table 15-2 describes NS activity and its associated status. 
Table 15-2. NS Activity 



Activity 



Status 



Description 



SAMLOAD 



STARTED 
COMPLETED 
ABORTED - error 



DUMP/LOAD REQUESTED 
DUMP STARTED 

COMPLETED 
ABORTED-error 



LOAD 



modname 
COMPLETED 
ABORTED - error 



error is any of the messages listed in table 15-3. 



error is any of the messages listed in table 15-3. 



modname is the name of the system module 
being loaded, error is any of the messages listed 
in table 15-3. 



Table 15-3 lists the error messages associated with NS activity status. 

Table 15-3. Load/Dump Status Messages 

Error Message Description 

TIMEOUT No response was received from the NPU during a preset time-out 

period. 

RETRY TIMEOUT Only abnormal responses were received from the NPU during a 
preset time-out period. 

FILE ERRORS Irrecoverable I/O error occurred on the network configuration file or 

network load file. 

PREEMPTED An incomplete SAM load or dump/load sequence was interrupted by 

a request from the same NPU to initiate a new SAM load. 



NS Recent HISTORY Command 

The HISTORY command requests a display of recent unsolicited status reports from NS 
(refer to Recent HISTORY Command later in this section for further information). 
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NVF Control Commands 

The HOP assigns the NAM K display to the network validation facility (NVF) to enter the 
following commands. 

Disable Host Element Command 

The HOP uses the DISABLE command to force immediate termination of a particular 
application or all host network operations. 

The command format is: 

DISABLE, operation. 

or 

DI, operation. 



Parameter Description 



operation One of the following: 



operation 



Keyword 
Abbreviation 



Description 



APPL=applicationname AP 



HOST 



HO 



applicationname is the name of 
the application to be disabled. If 
more than one copy of an 
application is allowed, then 
applicationname can be a 1- to 
5-character root name specifying 
that all copies of the named 
application are affected. 



Results of using the DISABLE^APPL command: 

• The status of the named application is changed from enabled (EN), active (AC), or down 
(DN) to disabled (DI), thereby prohibiting the application from accessing the 255x NPU 
network or CDCNET network. 

• If the application is active at the time the command is entered, NAM requests the 
application to immediately terminate access to the 255x NPU network or CDCNET 
network. If the application remains active for an undue period of time after entering 
this command, the HOP can resort to the DSD DROP or STOP command (refer to 
section 5, DSD Commands). 
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Results of using the DISABLE.HOST command: 

• NAM requests that all active applications in the host immediately terminate their 
access to both the 255x NPU network and CDCNET network. 

• When all applications (including CS, NS, and NETOU) terminate their access to the 
corresponding network, NAM and NVF also terminate. 

• If NAM or NVF do not terminate, enter the STATUS,APPL command to determine 
which application has not terminated. You can then use the DSD DROP or STOP 
command to drop the application. 

Enable Application Command 

The HOP uses the ENABLE command to change the status of a network application from 
disabled (DI) to enabled (EN). The application status becomes active (AC) when the 
application begins to access the network. 

The command format is: 

ENABLE, APPL=applicationname. 

or 

EN,AP=applicationname. 

Parameter Description 



applicationname Name of the application to be enabled. If more than one copy of an 
application is allowed, then applicationname can be a 1- to 
5-character root name specifying that all copies of the named 
application are affected. 



Idle Host Element Command 

The IDLE command terminates execution of an individual application or all host network 
operations. 

The command format is: 

IDLE , operation . 

or 

ID, operation. 
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Parameter Description 



operation One of the following: 

Keyword 
operation Abbreviation Description 



APPL=applicationname AP applicationname is the name of 

the application to be idled. If 
more than one copy of an 
application is allowed, then 
applicationname can be a 1- to 
5-character root name specifying 
that all copies of the named 
application are affected. 

HOST HO 



Results of using the IDLE,APPL command: 

• The application is warned of an imminent shutdown. 

• The application completes any operations in progress but does not allow any new 
connections. 

• When all users are disconnected, the application terminates normally. 
Results of using the IDLE,HOST command: 

• Applications are warned of an imminent shutdown. 

• New application requests to access either the 255x NPU network or CDCNET network 
are rejected. 

• New application to application connections are rejected. 

• New terminal connections to the host from either the 255x NPU network or the 
CDCNET network are rejected by NAM. 

• CS warns all connected NOPs and DOPs that shutdown of the network is imminent. CS 
terminates when all NOPs and DOPs end their connections to CS. COPs must be 
warned separately using CDCNET network operator commands. 

• NS ignores any new dump or load requests from NPUs. Any ongoing dump and load 
processes are completed normally before NS terminates. 

• Requests for MDI/MTI loads and dumps continue to be honored and NAM continues to 
start INITMDI. However, requests for loading and dumping other DIs are rejected, 
since connection requests from MDIs to NETFS are refused. 

• When all applications (including NS, CS, and NETOU) terminate their access to the 
network, NAM and NVF also terminate. If an application does not terminate, use the 
DISABLE command to request immediate termination of network activity in the host. 
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NVF Recent HISTORY Command 

The HISTORY command requests a display of recent unsolicited status reports from NVF 
(refer to Recent HISTORY Command later in this section for further information). 

Status Host Element Command 

Host elements are the applications associated with the host, terminals currently connected 
to the host, and users currently logged in to the host. With the STATUS command a HOP 
can status a single application, terminal device, or user name; or all applications, terminal 
devices, or users connected to a given application. 

There are five forms of the STATUS command. Refer to Status Message Formats for HOP, 
earlier in this section, for the format of the status line returned. 



Particular Host Element 

The first form requests the status of a particular host element. 

The command format is: 

STATUS , element . 

or 

ST, element. 



Parameter Description 



element One of the following. (If the following elementname is the name of an 
application and more than one copy of the application is allowed, then 
elementname can be a 1- to 5-character root name specifying that all copies 
of the named application are affected.) 



element 



Keyword 
Abbreviation 



Description 



APPL=elementname 



AP 



TERM=elementname 4 TE 



UNAME=elementname UN 



elementname is the name of the 
element whose status is desired. 

elementname is the name of the 
element whose status is desired. 

elementname is the name of the 
element whose status is desired. 



4. elementname may be the terminal name of a CDCNET terminal. Terminal names for CDCNET are 
assigned dynamically and are not associated with terminal names specified in the network configuration file. 
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Network Applications 

The second form requests the status of all network applications in the host. 

The command format is: 

STATUS, APPLS. 

or 

ST, APS. 

Active Network Applications 

The third form requests the status of all active network applications in the host. 

The command format is: 

STATUS , APPLS , AC . 

or 

ST, APS, AC. 



Terminal Devices 

The fourth form requests the status of all terminal devices connected to the specified 
application or logged in under the specified user name. 

The command format is: 

STATUS , TERMS , termelement . 

or 

ST , TES , termelement . 

Parameter Description 



termelement One of the following: 



termelement 



APPL=elementname 



Keyword 

Abbreviation Description 



AP 



UNAME=elementname UN 



elementname is the name of the 
desired application or user. 

elementname is the name of the 
desired application or user. 
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Users (Specified Application) 

The fifth form requests the status of all users connected to the specified application. 

The command format is: 

STATUS , UNAMES , APPL=applicationname . 

or 

ST, UNS, AP=applicationname . 

Parameter Description 

applicationname Name of the desired application. 
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Network Control by NOP 

The commands described later in this section are available to both HOPs and NOPs. The 
NOPs can perform all functions of the diagnostic operators as well as those unique to NOPs. 

The controlling NOP (refer to CONTROL command later in this section) is responsible for 
controlling one or more NPUs and its associated couplers, lines, logical links, terminal 
devices, and trunks. 

A controlling NOP can control any of the NPUs supervised by a CS and shares that 
responsibility with the HOP. The controlling NOP and HOP must, therefore, coordinate 
their activities. 

CS does not control or report the status of CDCNET network elements; therefore, none of 
the following commands apply to CDCNET. 

Becoming a NOP 

To become a NOP, you must be authorized by site personnel to access the CS application 
and to become a controlling NOP. 

After initiation of the network, you become a NOP as follows: 

1. Log in as described in the NOS Version 2 Reference Set, Volume 2. 

2. In response to the APPLICATION: prompt, enter: 

cs 

3. The system responds: 

HELLO, YOU ARE NOW AN NPU OPERATOR 

This message is followed by the prompt: 

READY. . 

You can now enter the NOP commands described later in this section. 

You can cancel a command that results in a large volume of output by entering the 
interruption or termination sequence (refer to the NOS Version 2 Reference Set, Volume 3). 



NOTE 



Use caution when cancelling output because unsolicited status messages could also be 
discarded. 
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When you cancel output, the message 

OUTPUT DISCARDED 
READY.. 

or 

OUTPUT DISCARDED. . 

appears at the terminal at the point from which the data was discarded. 

If the terminal is in page wait mode, 5 you must press CR after every page of output before 
more output can be sent to the terminal. 

To relinquish NOP status, enter one of the following. 

• To log out and end the terminal connection to the host, enter: 

GOODBYE 

or 

BYE 

or 

LOGOUT 

• To initiate a new login dialog, enter: 

HELLO 

or 

LOGIN 

• To remain logged in and be prompted for another application, enter: 

END 

• To remain logged in and be switched automatically to the application named applname, 
enter: 

END, applname 



5. Use a hardcopy device for NOP terminals; this prevents the paging problem and provides a permanent log of network events. 
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Status Message Formats for NOP 

Some of the NOP commands cause various status messages to be displayed on your 
terminal. The normal response to a STATUS command is one line of text returned when 
status is requested for a coupler, line, NPU, or terminal device. Two text lines can be 
returned when status is requested for logical links or trunks (if the CS to which you are 
connected is supervising NPUs at each end of the element, a line of text is returned for each 
end of the logical link or trunk). For multiple element status commands, a response is 
generated for all elements expressed or implied in the command. For example, a status 
request for all terminals on an NPU begins with a status report (text line) for the NPU. 
This is followed by a status report for the first active (AC) line on the NPU. A status report 
for each terminal device configured on the line follows. This is followed by a status report of 
the next active line and so on. 

The response to the ENABLE or DISABLE command is a status report for each element 
affected by that command. 

Following are the general formats for these status messages. 
Message Type Format ^ 



Coupler status line CPLER : name , status , nodenum, npunamel/cplnum. 

Line status line LINE : name , s tatus , 1 inetype , npunamel /port . 

Logical link status line LLINK : name , status , RL=n , loglinktype , npunamel /nodenum, 

npuname2 /nodenum . 

NPU status line NPU : name , status , nodenum, gostatus , dump . 

Archetype switched SVC : atname , EN=ennum, DI=dinum, AC=acnum, stip . 

virtual circuit (SVC) 

status line 

Terminal device status TERM: name, status, dt/tc, /hostnid,linename/al/a2,ldstat. 

fine 

Trunk status lin e TRUNK : name , s tatus , 1 ine type , npuname 1 / port , npuname2 / port . 
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In the preceding status message general formats the following variables are used. 

Variable Description ^ 

acnum Number of SVCs of the element that are in an active state (from to 255). 

atname Name of the archetype SVC element. 

al First level address (cluster address, configuration ordinal). 

a2 Second level address (terminal address, stream number). 

cplnum Coupler number for the indicated NPU. 

dinum Number of SVCs of the element that are in a disabled state (from to 255). 

dt Device type (CON, CR, LP, CP, PL). 

dump NPU dump flag (ON or OFF). 

ennum Number of SVCs of the element that are in an enabled state (from to 255). 

gostatus Go status of the NPU (if waiting for GO, NEEDGO appears). 

hostnid Host (coupler) node number of the host to which the terminal is currently 

connected. 

ldstat Load status of the trunk (LDDI means the trunk is disabled for loading; 

LDEN means the trunk is enabled for loading). 

linename Name of the line to which the terminal device is connected. 

linetype Line type (refer to the NDL Reference Manual). 

loglinktype Logical link type (H-N for host to NPU, H-H for host to host). 

name Name of the element. 

nodenum Node number of a coupler or NPU. 

npunamel Name of an NPU that supports or is connected to the element (also the 
name of the NPU that reported the status). 

npuname2 Name of the NPU at the other end of the logical link or trunk. 

port Port number of the line or trunk on the indicated NPU. 
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Variable Description 



RL=n Regulation level currently in effect. 

status Network elements are initially set to either a disabled or enabled state. 

Initially enabled elements automatically become active during the course of 
normal network operation. Every network element (such as line, logical 
link, NPU, or trunk) is in one of the following states. 

status Description __^__ 

AC Network element is active. An element becomes active when it is 

enabled and is handling network data traffic. 

DI Network element is disabled. The element cannot become active 

unless enabled by an operator command. 

DN Network element is down. A failure was detected that 

terminated data traffic for the element. If the failure condition 
ceases, the element returns to an enabled status. 

EN Network element is enabled. It was enabled by the operator and 

is in a physically operative condition. 

NC Network element is not configured. The NPU does not recognize 

the element. 



stip 
tc 



SubTIP type (PAD or APPL). 
Terminal class. 



Unsolicited Status Reports for NOP 

Each time a significant event occurs, CS updates its recent history buffer (refer to Recent 
HISTORY Command later in this section) and logs the event in the NAM dayfile. CS then 
sends a report about the event, called the unsolicited status report, to all NOPs who have 
selected to receive unsolicited status reports from the NPU (refer to Report Unsolicited 
Status Command later in this section). Unsolicited status reports are time-stamped 
whereas solicited status reports are not time-stamped. 

A single unsolicited status report occurs as a result of an element recovery or failure. An 
unsolicited status message is sent when an NPU joins the network. Batches of unsolicited 
status reports can occur as a result of an operator command to enable all elements of a 
given type (refer to Enable Network Element Command later in this section). 



60459300 U 



Network Operations 15-25 



Network Control by NOP 



NOP Commands 

All NOP commands consist of a command verb and, sometimes, one or more parameters. 
The commands must begin in the first character position and contain no blanks. The 
terminator (.) is optional. Some command verbs and parameters can be shortened to a 2- or 
3-character abbreviation. You can mix abbreviated and unabbreviated command verbs and 
parameters in all network commands. Parameters are order independent except where 
noted. You can enter commands pertaining only to the NPUs supervised by the CS to which 
you are connected. 

To enter the following commands you must control the NPU (refer to CONTROL Command 
later in this section). 

ALERT Command 

The ALERT command changes the threshold that CS uses for alerting the HOP and the 
controlling NOP of NPU saturation. 

The command format is: 

ALERT , CP=cpuse , BU=buf f , element . 

or 

AL , CP=cpuse , BU=buf f , element . 

Parameter Description __^__ 

cpuse Percent of the NPU central processor currently in use (from 50 to 100 

percent). 

buff Number of available NPU data buffers (from to 500). 

element One of the following: 

Keyword 

element Abbreviation Description 

NPU=npuname NP npuname is the name of the NPU 

supervised by your CS. 

NPUS NPS 



If the CPU usage reported to CS by the NPU is greater than cpuse, the HOP and the 
controlling NOP are alerted. If the buffer availability reported to CS by the NPU is less 
than buff, the HOP and the controlling NOP are alerted. To turn off all messages, set 
CP=100 and BU=0. 
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CONTROL Command 

After establishing communication with a CS, you can gain or lose control of one or more 
NPUs supervised by your CS with the CONTROL command. 

The command format is: 

CONTROL, option, status . 

or 

CO, option, status . 

Parameter Description _^___ 

option One of the following: 

Keyword 

option Abbreviation Description 

npuname is the name of the NPU. 



NPU=npuname 


NP 


NPUS 


NPS 


AUTO 


AU 


ON or OFF. 





status 

The NPU=npuname option allows you to gain control of a specific NPU. The NPUS option 
allows you to gain control over all uncontrolled NPUs currently supervised by your CS. The 
AUTO option allows you to gain control over all uncontrolled NPUs currently supervised by 
your CS and all other uncontrolled NPUs that may later come under the supervision of your 
CS. The AUTO option can be cancelled by entering any valid CONTROL command with the 
OFF status specified. 
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Example: 

Suppose there are four NPUs (1, 2, 3, and 4) available to be controlled in the network. The 
first NOP logs in to CS and controls NPU 1. The second NOP establishes a connection to CS 
and enters the CONTROL,AUTO,ON command. The second NOP becomes the controlling 
NOP and controls all of the uncontrolled NPUs (in this example 2, 3, and 4). When the first 
NOP relinquishes control of NPU 1, that NPU is then controlled by the second NOP. The 
second NOP also controls all of the new NPUs joining the network automatically. 

If no other NOP exists for the NPUs specified, the response to a request for control consists 
of a list of the NPUs you now control followed by a READY., prompt; otherwise, you receive 
a diagnostic messsage. 

Since a HOP automatically controls all NPUs being supervised by a CS, the CONTROL 
commands are not used by the HOP. Whenever a NOP loses control of an NPU for any 
reason (including ending the connection to CS or the failure of some network element that 
was supporting the connection to CS), CS informs the HOP and all other connected NOPs 
by sending an unsolicited status report. 

If any NOP has AUTO control status, the operators are informed of the identity of the 
controlling NOP. Whenever a CS gains supervision of a new NPU, the HOP, all NOPs, and 
all DOPs are informed that the NPU is being supervised. 
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Disable Network Element Command 

The controlling NOP changes the status of a network element from enabled (EN), active 
(AC), or down (DN), to disabled (DI) by the DISABLE command. 

There are three forms of the DISABLE command. Refer to Status Message Formats for 
NOP, earlier in this section, for the format of the status line returned. 



Single Element 

The first form disables a single element in a network. 

The command format is: 

DISABLE , element . 
or 

DI, element. 

Parameter Description 

element One of the following: 

element . 



Keyword 
Abbreviation 



LINE=elementname LI 



LLINK=elementname LL 



TERM=elementname TE 



TRUNK=elementname TR 



Description 



elementname is the name of the 
element to be disabled. 

elementname is the name of the 
element to be disabled. 

elementname is the name of the 
element to be disabled. 

elementname is the name of the 
element to be disabled. 



For a logical link or trunk, if the element is active when the command is entered, all data 
traffic through the element is terminated and the affected host application programs and 
terminal users are notified. For a line or terminal, if the element is active when the 
command is entered, all data traffic through the element is terminated and only the affected 
host application programs are notified. 



60459300 U 



Network Operations 15-29 



Network Control by NOP 

Trunk 

The second form disables a trunk for loading. 

The command format is: 

DISABLE , TRUNK=trunkname , LD . 

or 

DI , TRUNK=trunkname , LD . 

Parameter Description 



trunkname Name of trunk to be disabled for loading. 

If the trunk is enabled, it will still be enabled after this command is issued, but it will be 
disabled for loading. 

SVCs 

The third form disables archetypical switched virtual circuits (SVCs) that are in an enabled 
state. 

The command format is: 

DISABLE , SVC=atname , NCIR=numcir . 

or 

DI , SV=atname , NC=numcir . 



Parameter Description 



atname Archetypical SVC name. 

numcir Number of SVCs to change from an enabled state to a disabled state. 



DISABLE Processing 

This form of the DISABLE command allows you to decrease the number of enabled SVCs for 
a particular X.25 subTIP type. If the number of enabled SVCs is greater than or equal to 
numcir, then the number of disabled SVCs is increased by numcir and the number of 
enabled SVCs is decreased by numcir. If the number of enabled SVCs is less than numcir, 
then the number of disabled SVCs is increased by the number of available enabled SVCs 
and the number of enabled SVCs is set to zero. Disabling SVCs has no effect on active 
SVCs. If, for a particular SVC element, the command could not be executed, an unsolicited 
status report is sent to you giving the reason the command was not executed. 

The NPUs affected by the command send an unsolicited status report indicating the new 
status for the element. 
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Trunks and logical links can have two owning NPUs (one at each end of the trunk or logical 
link). When two NPUs are involved and both are supervised by your CS, the 
DISABLE,TRUNK and DISABLE,LLINK commands are processed as follows: 

• If one of the NPUs is local and one is remote, the command is forwarded to the local 
NPU. 

• If both of the NPUs are local or both are remote, the command is forwarded to the NPU 
with the lower node number. 

• If your CS supervises only one of the NPUs, the command is forwarded to that NPU. 

In either case, the trunk or logical link enters the disabled (DI) state at the owning NPU 
that receives the DISABLE command and is detected as being down (DN) by the other 
NPU. Both of these changes are reported to CS, which informs all operators of the changes 
by sending unsolicited status reports. 

If a single NPU owns both ends of the link, the command is forwarded to that NPU. This 
status change is also reported by sending unsolicited status reports. 

Disabling a trunk can cause one or more logical links to go down. The owning NPUs report 
the failure of these links by sending unsolicited status reports. 



NOTE 



No attempt is made to protect you from disabling network elements that support your 
connection to CS. You may lose contact with CS as a result of such a command. When this 
happens, you may need to use another terminal or the host console to enable the disabled 
network element. 
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Enable Network Element Command 

The controlling NOP changes the status of one or more network elements from disabled (DI) 
to enabled (EN), allowing the element(s) to become active for data traffic by the ENABLE 
command. 

There are six forms of the ENABLE command. Refer to the Status Message Formats for 
NOP, earlier in this section, for the format of the status line returned. 



Single Element 

The first form enables a single element in the network. 

The command format is: 

ENABLE, element . 
or 

EN, element . 

Parameter Description 



element One of the following: 



element 



Keyword 
Abbreviation 



Description 



LINE=elementname 



LI 



LLINK=elementname LL 



TERM=elementname TE 



TRUNK=elementname TR 



elementname is the name of the 
element to be enabled. 

elementname is the name of the 
element to be enabled. 

elementname is the name of the 
element to be enabled. 

elementname is the name of the 
element to be enabled. 
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Trunk 

The second form enables a trunk for loading. It will also enable the trunk if it is disabled. 

The command format is: 

ENABLE , TRUNK= trunkname , LD . 

or 

EN , TRUNK= trunkname , LD . 

Parameter Description 

trunkname Name of the trunk to be enabled for loading. 

Disabled Elements 

The third form enables all disabled elements of the specified type on an NPU. 

The command format is: 

ENABLE , element , NPU=npuname . 

or 

EN, element , NP=npuname . 

Parameter Description ^ _____ 



element One of the following: 

element Keyword Abbreviation 

LINES LIS 

LLINKS LLS 

TERMS TES 

TRUNKS TRS 

npuname Name of an NPU. 
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Disabled Elements (All NPUs) 

The fourth form enables all disabled elements of the specified type on all NPUs. 

The command format is: 

ENABLE , element , NPUS . 

or 

EN, element , NPS . 

Parameter Description 

operation One of the following: 

element Keyword Abbreviation 



LINES 


LIS 


LLINKS 


LLS 


TERMS 


TES 


TRUNKS 


TRS 



Disabled Terminals 

The fifth form enables all disabled terminals on a line. 

The command format is: 

ENABLE , TERMS , LINE=terml ine . 

or 

EN, TES , LI=termline . 

Parameter Description 



termline Name of the line to which terminals are connected. 
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SVCs 

The sixth form enables SVCs that are in a disabled state. 

The command format is: 

ENABLE , SVC=atname , NCIR=numcir . 

or 

EN, SV=atname , NC=numcir . 



Parameter Description 



atname Archetype SVC name. 

numcir Number of SVCs to change from a disabled state to an enabled state. 

ENABLE Processing 

The ENABLE,TRUNK and ENABLE,LLINK commands are forwarded to both of the owning 
NPUs (one at each end of the trunk or logical link) if both are supervised by your CS. 
Enabling a trunk can cause one or more logical links with a down status to become enabled 
or active. Status changes resulting from enabling a trunk or logical link are reported by the 
owning NPUs by sending unsolicited status reports. 

Enabling a trunk can cause CS to become available to an NPU and, therefore, allow CS to 
gain control of an NPU. 

The ENABLE command allows you to enable all lines or terminal devices on an NPU. When 
you enable all lines or terminal devices of a given type on an NPU or all terminals on a line, 
the NPU or line affected by the command sends an unsolicited status report telling you how 
many elements of the given type are curently disabled. The NPU then sends unsolicited 
status reports telling the new status of each element for which the command was executed. 
If, for a particular element, the command could not be executed, an unsolicited status report 
is sent to you giving the reason the command was not executed. 

The ENABLE,SVC command allows you to increase the number of enabled SVCs for a 
particular X.25 subTIP type. If the number of disabled SVCs is greater than or equal to 
numcir, then the number of enabled SVCs is increased by numcir. If the number of disabled 
SVCs is less than numcir, then the number of enabled SVCs is increased by the number of 
disabled SVCs and the number of disabled SVCs is set to zero. Enabling SVCs has no effect 
on active SVCs. If, for a particular SVC element, the command could not be executed, an 
unsolicited status report is sent to you giving the reason the command was not executed. 
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NPU GO Command 

After establishing a connection with CS, the newly supervised NPU may ask for a GO 
command from the controlling NOP. 

The GO command format is: 

GO , NPU=npuname . 

or 

GO , NP=npuname . 

Parameter Description 

npuname Network defined name of the NPU. 

If there is a controlling NOP for the NPU when CS receives a GO request, the GO request is 
relayed to the controlling NOP and to the HOP. If there is no controlling NOP, the GO 
request is relayed to the HOP and to all currently connected NOPs. The HOP or controlling 
NOP (if there is one) can, as needed, request status information or enable/disable network 
elements. Thus, the controlling NOP can control the initial status or the network elements 
connected to or supported by a given NPU prior to that NPU beginning terminal operations. 

The GO request message is repeated periodically until an operator takes control of the NPU 
and enters the GO command. 

Upon entry of the GO command the NPU proceeds to activate lines and accept terminal 
connections. 
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NPU LOAD Command 

The LOAD command causes an active (AC) NPU or all active NPUS to be stopped, reloaded, 
and reactivated. 

There are two forms of the LOAD command. 



Specified NPU 

The first form causes the specified NPU to be stopped, reloaded, and reactivated. 

The command format is: 

LOAD , NPU=npuname , dumpoption . 

or 

LO , NP=npuname , dumpoption . 

Parameter Description 



npuname Name of the NPU. 

dumpoption Optional dump parameter; one of the following: 
dumpoption Keyword Abbreviation 



DUMP DU 

NDMP ND 



If the DUMP option is specified, a memory dump of the NPU is taken prior to reloading. If 
the NDMP option is specified, the NPU is reloaded without taking a memory dump. If the 
dump status is not specified, taking a memory dump depends upon the setting of the dump 
flag. Refer to NPU Memory Dump Command, next, for more information. The DUMP or 
NDMP option is in effect only for the immediate load. It has no permanent effect on the 
NPU memory dump flag. 

When an NPU executes a LOAD command, the CS connection to that NPU is lost during 
the dump/load process. The trunks and logical links supported by the NPU are detected as 
down (DN) by the NPUs at the other ends of the trunks and logical links. All of the 
appropriate operators receive corresponding unsolicited status reports. 
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All NPUs 

The second form causes all active NPUs to be stopped, reloaded, and reactivated. 

The command format is: 

LOAD , NPUS , dumpoption . 

or 

LO , NPS , dumpoption . 

Parameter Description 



dumpoption Optional parameter; one of the following: 
dumpoption Keyword Abbreviation 



DUMP DU 

NDMP ND 



If the DUMP option is specified, a memory dump of all active NPUs (supervised by this 
host) is taken prior to reloading. If the NDMP option is specified, the NPUs are reloaded 
without taking a memory dump. If the dump status is not specified, taking a memory dump 
depends upon the setting of the dump flag. Refer to NPU Memory Dump Command, next, 
for more information. The DUMP or NDMP option is in effect only for the immediate load. 
It has no permanent effect on the NPUs memory dump flag. 

When all of the NPUs execute LOAD commands, the corresponding CS connections to the 
NPUs are lost during the dump/load process. The trunks and logical links supported by the 
NPUs are detected as down (DN) by the NPUs at the other ends of the trunks and the 
logical links. The appropriate operators receive corresponding unsolicited status reports. 
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NPU Memory DUMP Command 

The DUMP command causes the memory dump flag to be reset for the specified NPU or 
NPUs. Initially, this reset condition is set independently for every NPU in the network and 
is specified on the NPU statement (refer to the NDL Reference Manual for more information 
on the NPU statements). 

There are two forms of the DUMP command. 

Specified NPU 

The first form causes a memory dump of the specified NPU to be taken. 

The command format is: 

DUMP , NPU=npuname , status . 

or 

DU , NP=npuname , status . 

Parameter Description 

npuname Name of the NPU. 
status ON or OFF. 

All NPUs 

The second form causes a memory dump of all NPUs to be taken. 

The command format is: 

DUMP, NPUS, status . 

or 

DU,NPS, status. 

Parameter Description 

status ON or OFF. 

If status is ON, a memory dump will be taken the next time the NPU is reloaded (unless 
overridden by the LOAD command). If status is OFF, a memory dump will not be taken the 
next time the NPU is reloaded (unless overridden by the LOAD command). 
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Send Message Command 

A controlling NOP can send a message to the HOP or any terminal device user or group of 
terminal device users using the SEND command. The NOP can address the message to a 
single user or to all users on the specified line, logical link, NPU, or all NPUs under the 
supervision of the CS. 

The HOP cannot use the HOST element to send a message. 

The command format is: 

SEND, element , MSG=message . 

or 

SE , element „ MS=message . 



Parameter Description 



element One of the following: 



element 



Keyword 
Abbreviation 



Description 



LINE=elementname LI 



LLINK=elementname LL 



NPU=elementname NP 



TERM=elementname TE 



HOST 
NPUS 



HO 

NPS 



elementname is the name of the 
element to which the message is 
addressed. 

elementname is the name of the 
element to which the message is 
addressed. 

elementname is the name of the 
element to which the message is 
addressed. 

elementname is the name of the 
element to which the message is 
addressed. 



message Text message of no more than 50 characters. If more than 50 characters are 
entered, a diagnostic message is issued. The MSG=message parameter is 
order dependent and must appear as the last parameter of the command. 

CS, upon accepting a SEND command, does not issue the READY., prompt until processing 
of the SEND command has completed, to prevent an NPU from being flooded with operator 
messages. CS sends a message to you as each NPU receives the SEND command. When 
processing is complete, CS sends the READY., message. 

If a terminal is specified as the network element, it must be an interactive terminal device. 
Otherwise, an error message is issued to the sender. 

If the element referenced by a SEND command is not currently active or enabled, you 
receive an error message. This error message is followed by a status line for the element; 
the operator is thus informed why the message could not be delivered. The status text line 
is followed by the READY., prompt. 
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Network Control by DOP 

The commands described next are available to the HOPs, NOPs, and DOPs, but not COPs. 
All DOPs can obtain unsolicited status reports and use status and diagnostic commands. 

Becoming a DOP 

To become a DOP you must be authorized by site personnel to access CS. 
After initiation of the network, you become a DOP as follows: 

1. Log in as described in the NOS Version 2 Reference Set, Volume 2. 

2. In response to the APPLICATION: prompt, enter: 

cs 

3. The system responds: 

HELLO, YOU ARE NOW A DIAGNOSTIC OPERATOR 

This message is followed by the prompt: 

READY. . 

You can now enter the DOP commands described later in this section. 

You can cancel a command that results in a large volume of output by entering the 
interruption or termination sequence (refer to the NOS Version 2 Reference Set, Volume 3). 



NOTE 



Use caution when cancelling output because unsolicited status messages could also be 
discarded. 



When you cancel output, the message 

OUTPUT DISCARDED 
READY. . 

or 

OUTPUT DISCARDED. . 

appears at the terminal at the point from which the data was discarded. 
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If the terminal is in page wait mode, 6 you must press CR after every page of output before 
more output can be sent to the terminal. 

To relinquish DOP status, enter one of the following: 

• To logout and end the terminal connection to the host, enter: 

GOODBYE 

or 

BYE 

or 

LOGOUT 

• To initiate a new login dialog, enter: 

HELLO 
or 

LOGIN 

• To remain logged in and be prompted for another application, enter: 

END 

• To remain logged in and be switched automatically to the application named applname, 
enter: 

END, applname 



6. Use a hardcopy device for DOP terminals; this prevents the paging problem and provides a permanent log of network events. 



15-42 NOS Version 2 Analysis Handbook 60459300 U 



Network Control by DOP 



Status Message Formats for DOP 

Some of the DOP commands cause various status messages to be displayed on your 
terminal. The normal response to a STATUS command is one line of text returned when 
status is requested for a coupler, line, NPU, or terminal device. Two text lines can be 
returned when status is requested for logical links or trunks (if the CS to which you are 
connected is supervising NPUs at each end of the element, a line of text is returned for each 
end of the logical link or trunk). For multiple element status commands, a response is 
generated for all elements expressed or implied in the command. For example, a status 
request for all terminals on an NPU begins with a status report (text line) for the NPU. 
This is followed by a status report for the first active (AC) line on the NPU. A status report 
for each terminal device configured on the line follows. This is followed by a status report of 
the next active line and so on. 

The following are the general formats for these status messages. 

Message Type Format 

Coupler status line CPLER: name, status, nodenum, npunamel/cplnum. 

Line status fine LINE : name , status , linetype , npunamel/port . 

Logical link status line LLINK: name, status, RL=n,loglinktype,npunamel/nodenum, 

npuname2 /nodenum . 

NPU status line NPU : name , status , nodenum, gostatus , dump . 

Archetype switched svc : atname , EN=ennum, DI=dinum, AC=acnum, stip . 

virtual circuit (SVC) 

status line 

Terminal device status TERM: name, status, dt/tc,/hostnid,linename/al/a2. 

line 

Trunk status line TRUNK : name , status , linetype , npunamel/port , npuname2 /port . 
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In the preceding 
Variable 



status message general formats the following variables are used. 
Description 



acnum Number of SVCs of the element that are in an active state (from to 255). 

atname Name of the archetype SVC element. 

al First level address (cluster address, configuration ordinal). 

a2 Second level address (terminal address, stream number). 

cplnum Coupler number for the indicated NPU. 

dinum Number of SVCs of the element that are in a disabled state (from to 

255). 

dt Device type (CON, CR, LP, CP, PL). 

dump NPU dump flag (ON or OFF). 

ennum Number of SVCs of the element that are in an enabled state (from to 

255). 

gostatus Go status of the NPU (if waiting for GO, NEEDGO appears). 

hostnid Host (coupler) node number of the host to which the terminal is currently 

connected. 

linename Name of the line to which the terminal device is connected. 

linetype Line type (refer to the NDL Reference Manual). 

loglinktype Logical link type (H-N for host to NPU, H-H for host to host). 

name Name of the element. 

nodenum Node number of a coupler or NPU. 

npunamel Name of an NPU that supports or is connected to the element (also the 

name of the NPU that reported the status). 

npuname2 Name of the NPU at the other end of the logical link or trunk. 

port Port number of the line or trunk on the indicated NPU. 

RL=n Regulation level currently in effect. 
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Variable Description 



status Network elements are initially set to either a disabled or enabled state. 

Initially enabled elements automatically become active during the course 
of normal network operation. Every network element (such as line, 
logical link, NPU, or trunk) is in one of the following states. 

status Description — 

AC Network element is active. An element becomes active when 

it is enabled and is handling network data traffic. 

DI Network element is disabled. The element cannot become 

active unless enabled by an operator command. 

DN Network element is down. A failure was detected that 

terminated data traffic for the element. If the failure 
condition ceases, the element returns to an enabled status. 

EN Network element is enabled. It was enabled by the operator 

and is in a physically operative condition. 

NC Network element is not configured. The NPU does not 

recognize the element. 



stip SubTIP type (PAD or APPL). 

tc Terminal class. 

Unsolicited Status Reports for DOP 

Each time a significant event occurs, CS updates its recent history buffer (refer to Recent 
HISTORY Command later in this section) and logs the event in the NAM dayfile. CS then 
sends a report about the event, called the unsolicited status report, to all DOPs who have 
selected to receive unsolicited status reports from the NPU (refer to Report Unsolicited 
Status Command later in this section). Unsolicited status reports are time-stamped 
whereas solicited status reports are not time-stamped. 

DOP Commands 

All DOP commands consist of a command verb and, sometimes, one or more parameters. 
The command must begin in the first character position and contain no blanks. The 
terminator (.) is optional. Some command verbs and parameters can be shortened to a 2- or 
3-character abbreviation. You can mix abbreviated and unabbreviated command verbs and 
parameters in all network commands. Parameters are order independent except where 
noted. You can enter commands pertaining only to the NPUs supervised by the CS to which 
you are connected. 
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CS Information Command 

You can access information about all operators and NPUs connected to and supervised by 
your CS with the INFO command. 

The command format is: 

INFO. 

or 

IN. 

The response lines are an operator information line and an NPU information line for each 
operator (DOP and NOP) and for each NPU supervised by a CS, respectively. 

The format of the operator information line is: 

DOP : termname , username , acn . 
NOP: termname, username, acn, auto. 

The format of the NPU information line is: 

NPU : npuname , status , nodenum, go-status , nopname . 
In the preceding information line formats the following variables are used. 

Variable Description 

acn CS application connection number. 

auto Control status of the NOP (if the NOP is an auto control NOP, AUTO 

appears). Refer to the NOP CONTROL command described earlier in this 
section. 

nodenum Node number of the NPU. 

nopname Terminal name of the NOP that is controlling the NPU. If the NPU has no 

controlling NOP, the field is blank. 

npuname Name of the supervised NPU. 

status Status of the NPU. (AC if the NPU is active, MI if the NPU is in a 

mismatch condition). 

termname Name of the terminal at which the DOP or NOP resides. 

username User name of the DOP or NOP. 

go-status If the NPU is waiting for GO, NEEDGO is displayed. 
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NPU Diagnostic Test Command 

The TST command allows any operator to request, interact with, or terminate the 
diagnostic program within any NPU supervised by a CS. 

The command format is: 

TST , NPU=npuname , option . 

or 

TS , NP=npuname , option . 

Parameter Description 



npuname Name of the NPU containing the diagnostic program with which the 

operator wants to communicate. 



option 



One of the following: 



option 

DROP 



Keyword 

Abbreviation Description 



DR 



MSG=message 



REQUEST 



MS 



RE 



message is the command that 
controls the execution of the 
diagnostic program in the NPU. 



CS keeps track of which NPUs are currently running diagnostic tests and which operators 
are using them. A single operator is permitted to perform diagnostic tests in several 
different NPUs simultaneously. All operators can interact with the diagnostics in a single 
NPU, but only one operator can run the diagnostics. 

TST Drop Option 

The DROP parameter cancels your diagnostic program reservation in the specified NPU. All 
diagnostics currently being performed by you in the specified NPU are terminated. If the 
diagnostic program is not executing, the TST command is ignored and an error message is 
returned. 



60459300 U 



Network Operations 15-47 



Network Control by DOP 



TST Message Option 

The MSG=message parameter allows you to interact with an NPU diagnostic program. It 
allows you to send a command message in the form of a text string to the diagnostic 
program in the specified NPU. A typical use of the message option is to initiate and 
terminate diagnostic tests. The option is accepted only if you previously entered and 
confirmed a REQUEST option; otherwise, an error message is received. Refer to the CCP 3 
Diagnostic Handbook for more information. 

The diagnostic program sends text messages through CS to you. The message is an 
unsolicited status report with this format: 

FROM npuname/DIAGNOSTIC: TO termname: 
mess age text 

Variable Description 

npuname Name of the NPU. 

termname Name of your terminal. 

messagetext Message from the diagnostic program. 



TST Request Option 

The REQUEST parameter allows you to initiate interaction with an NPU diagnostic 
program. An NPU diagnostic program is assigned to you until one of these events occurs: 

• You drop the diagnostic program (by sending a TST command with the DROP option). 

• The connection between you and CS is terminated for any reason. 

• Supervision of the NPU is lost by CS. 
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Recent HISTORY Command 

The HISTORY command requests a display of the recent unsolicited status reports from a 
CS. 

The command format is: 

HISTORY, ALL. 

or 

HI, ALL. 

If the ALL option is not used, only the last (most recent) page (based on your terminal's 
page size) of the unsolicited status reports is displayed. 

Any DOP or NOP can enter the HISTORY command to obtain reports from CS. 

A HOP can enter the HISTORY command to obtain reports from CS, NS, or NVF after 
assigning the NAM K display to the desired application (refer to section 8, K-Display 
Utilities, for more information on the NAM K display). 

Each application maintains a separate record of the most recent significant NPU load, DOP, 
NOP, or HOP events. The occurrence of these various significant events prompts the 
sending of an unsolicited status report to all appropriate operators. All reports are 
temporarily available through the HISTORY command and are permanently recorded in the 
NAM dayfile. 

A CDCNET operator can enter the DISPLAY_ALARM_HISTORY command to obtain 
reports from NETOU. Refer to the CDCNET Network Operations Manual for more 
information about this command. 
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Report Unsolicited Status Command 

The REPORT command requests a CS to report all unsolicited status messages from an 
NPU. 

The command format is: 

REPORT , element , option 
or 

RE , element , option 

Parameter Description 

element One of the following: 

Keyword 
element Abbreviation Description 

NPU=npuname NP npuname is the name of the NPU. 

NPUS NPS 

option ON or OFF. If option is not specified, OFF is assumed. If option is ON, CS 

reports all unsolicited status messages until you turn reporting off. 

Initially, HOPs do not receive reports for any NPUs supervised by a CS, but controlling 
NOPs receive reports for the NPUs they control. Other NOPs and DOPs do not receive any 
reports. However, any operator can use this command to request unsolicited status reports 
from any NPU supervised by a CS. 
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Send Message Command 

A DOP can send a message to any of the other operators (HOP, NOPs, and other DOPs) 
connected to the same CS using the SEND command. 

The command format is: 

SEND , element , MSG=message 

or 

SE, element, MS=message 



Parameter Description 



element 



One of the following: 



element 



Keyword 
Abbreviation 



Description 



TERM=termname TE 



termname is the name of the 
terminal to which the message is 
addressed. 



HOST 



HO 



message 



Text message of no more than 50 characters. If more than 50 characters 
are entered, an error message is issued. The MSG=message parameter is 
order dependent and must appear as the last parameter of the command. 



If a terminal device is specified as the network element, it must be an interactive terminal 
device currently connected to your CS. Otherwise, an error message is issued to the sender. 

If you specify HOST, the message is sent to the HOP of the host to which you are connected. 

If the element referenced by a SEND command is not currently connected to a CS, you 
receive a diagnostic message. The diagnostic message is followed by the READY., prompt. 
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Status Network Element Command 

You request a CS to display status information on the various 255x NPU network elements 
(such as couplers, NPUs, and trunks) with the STATUS command. 

There are five forms of the STATUS command. Refer to the Status Message Formats for 
DOP, earlier in this section, for the format of the status line returned. 

Particular Element 

The first form requests the status of a particular element in the network. 

The command format is: 

STATUS, element . 

or 

ST , element . 

Parameter Description 



element 



One of the following: 



element 



Keyword 
Abbreviation 



Description 



CPLER=elementname CP 



LINE=elementname LI 



LLINK=elementname LL 



NPU=elementname NP 



SVC=elementname SV 



TERM=elementname TE 



TRUNK=elementname TR 



elementname is the name of the 
element whose status is desired. 

elementname is the name of the 
element whose status is desired. 

elementname is the name of the 
element whose status is desired. 

elementname is the name of the 
element whose status is desired. 

elementname is the name of the 
element whose status is desired. 

elementname is the name of the 
element whose status is desired. 

elementname is the name of the 
element whose status is desired. 
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Ml Elements 

The second form requests the status of all of the elements of a particular type on one or all 

NPUs. 

The command format is: 

STATUS , linkelement npuelement , statuscode . 

or 

ST, linkelement, npuelement , statuscode. 

Parameter Description 



linkelement 


One of the following: 




linkelement 


Keyword 
Abbreviation 




CPLERS 


CPS 




LINES 


LIS 




LLINKS 


LLS 




svcs 


SVS 




TEEMS 


TES 




TRUNKS 


TRS 


npuelement 


One of the following: 




npuelement 


Keyword 

Abbreviation Description 




NPU=npuname 


NP npuname is the name of the NPU. 




NPUS 




statuscode 


Optional. If specified, only the elements with that status are reported. 




statuscode 

AC 


Description 




Active 




DN 


Down 




DI 


Disabled 




EN 


Enabled 
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Terminal Devices 

The third form requests the status of all terminal devices on a line or a logical link. 

The command format is: 

STATUS , TERMS , mode , statuscode . 

or 

ST,TES,mode, statuscode. 

Parameter Description 



mode 



statuscode 



One of the following: 



mode 



Keyword 
Abbreviation 



Description 



LINE=elementname LI 



LLINK=elementname LL 



elementname is the name of 
the specified element. 

elementname is the name of 
the specified element. 



Optional. If specified only the elements with that status are reported. 
statuscode Description 



AC 
DN 

DI 

EN 



Active 
Down 
Disabled 
Enabled 



NPUs 

The fourth form requests the status of all NPUs supervised by the CS. 

The command format is: 

STATUS, NPUS. 

or 

ST, NPUS. 
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SVCs 

The fifth form requests the status of all archetype SVCs on a line. 

The command format is: 

STATUS , SVCS , LINE=1 ine . 

or 

ST,SVS,LI=line. 

Parameter Description 



line Name of the specified line. 

A CS does not keep track of the status of the various network elements. NPUs supply the 
information required to satisfy the STATUS commands by sending messages to CS. In the 
case of a multiple-element status request, the number of messages sent can become 
significant. You cannot enter another command until all the messages are delivered and a 
READY., prompt is displayed. A controlling NOP, other NOPs, or the DOPs can cancel a 
STATUS command by entering the interruption or termination sequence (refer to the NOS 
Version 2 Reference Set, Volume 3 for details). A HOP can cancel a STATUS command by 
using the slant (/) key. 

When status is requested for a coupler, line, NPU, or terminal the normal response to the 
STATUS command is one line of text. When status is requested for logical links or trunks, 
two text lines may be returned (if the CS to which you are connected is supervising NPUs at 
each end of the element, a line of text is returned for each end of the logical link or trunk). 
When status is requested for archetype SVCs on a line, a text line with the line status is 
returned and a text line for each active archetype SVC is returned. 
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Summary of Network Operation Commands 

Following is a summary of the network operation commands. 

Control Commands for HOP 

The following commands are available only to the HOP. 

NAM K Display 

Assign the NAM K display by using one of the following (refer to section 8, K-Display 
Utilities, for additional information): 

Command Description 

KAP=CS. Assigns the NAM K display to the communication supervisor (CS). 

KAP=NS. Assigns the NAM K display to the network supervisor (NS). 

KAP=NVF. Assigns the NAM K display to the network validation facility (NVF). 

KAP=NETOU. Assigns the NAM K display to the network operator utility (NETOU). 

K* Assigns the NAM K display back to NAM mode after it has been 

assigned to CS, NS, NVF, or NETOU. 

NAM Startup 

Initiate NAM by entering NAM. 

NAM Shutdown 

The sequence of commands used to shutdown NAM is: 

K.AP=NVF. 

K. DISABLE, HOST. 

or 

K. IDLE, HOST. 
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NAM Mode Commands 

The HOP assigns the NAM K display to NAM mode before entering any of the following 
commands: 



Command 



DB 7 

DE 7 

DU 7 

END 

FL 

HELP 

IG 

LB 7 

LE 7 

LR 7 

RS 7 

SEND 
ST 



Description 



Activates the inline debug code. 

Deactivates the inline debug code. 

Activates field length dump. 

Clears the NAM K display. 

Changes NAMs maximum field length. 

Displays information about the NAM mode commands on the right 
K-display screen. 

Causes NAM to ignore alert requests. 

Begins logging of the network traffic on the debug log file. 

Ends logging of the network traffic on the debug log file. 

Releases the debug log file. 

Dumps the statistics data to the statistics file, resets the counters to 
(zero), and continues gathering statistics. 

Sends a message to another HOP. 

Causes the NAM status display to appear on the left K-display screen. 



7. These commands are supported by the network supervisory applications CS, NS, NVF. and NETOU. They are ignored by IAF. 
TAF. and many other network applications. 
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NS Control Commands 

The HOP assigns the NAM K display to NS before entering any of the following commands: 8 

Command Description 

FILE Assigns an alternate load file to NS for loading the specified NPU. 

HISTORY Requests a display of the recent unsolicited status reports. 

NOFILE Instructs NS to use the default NPU load file for loading all NPUs. 

STATUS Requests the current load/dump status of NPUs. 



NVF Control Commands 

The HOP assigns the NAM K display to NVF before entering any of the following 
commands: 8 

Command Description 

DISABLE Disables an application or all host network operations for both the 255x 

NPU network and CDCNET network. 

ENABLE Enables an application. 

IDLE Terminates an application or all host network operations for both the 255x 

NPU network and CDCNET network. 

HISTORY Requests a display of the recent unsolicited status reports. 

STATUS Requests the status of network elements. 



8. To use the abbreviated form of commands, you can type the first two letters of the command. For example. FI for FILE. 
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Control Commands for HOP and NOP 

The HOP assigns the NAM K display to CS before entering any of the following commands. 
The NOP can enter these commands 9 by logging into CS. 

Command Description 



ALERT Changes the threshold that CS uses for alerting the NOP and HOP of 
NPU saturation. 

CONTROL Allows you to gain or give up control of NPUs. 

DISABLE Changes the status of the specified elements to disabled. 

DUMP Causes the memory dump flag to be reset for the specified NPU. 

ENABLE Changes the status of the specified elements to enabled. 

GO Activates the lines and accepts terminal device connections on an NPU. 

LOAD Causes active NPUs to stop, reload, and reactivate. 

SEND Sends a message of no more than 50 characters to users. 



Control Commands for HOP, NOP, and DOP 

The HOP assigns the NAM K display to CS before entering any of the following commands. 
The DOP and NOP can enter these commands 9 by logging into CS. 

Command Description 



INFO Accesses information about all operators and NPUs connected to CS. 

HISTORY Requests a display of the recent unsolicited status reports. 

REPORT Requests CS to report all unsolicited status messages from NPUs. 

SEND Sends a message of no more than 50 characters to the HOP or another 

NOP or DOP. 

STATUS Requests the status of network elements. 

TST Allows you to control interaction with an NPU diagnostic program in the 

specified NPU. 



Control Commands for COP 

Refer to the CDCNET Network Operations Manual for information about control commands 
intended for the CDCNET operator. 



9. To use the abbreviated form of commands, you can type the first two letters of the command. For example, IN for INFO. 
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NAM supports two types of networks: the 255x NPU network and the CDCNET network. 
Throughout this section, the term network refers to the 255x NPU network. However, 
whenever a statement is applicable to both network types, both types are named explicitly. 

This section describes the following utilities and files involved in the operation of the 
networks and interactive subsystems of NOS. 

• NAM Initialization (NAMI). This utility controls the network software startup process. 

• Network Dump Collector (COLLECT). This utility produces tape files from the various 
NPU, CDCNET device interface, and host dump, trace, statistics, and list files that 
were generated by any abnormal termination of either the 255x NPU network or the 
CDCNET network. 

• Load File Generator (LFG). This utility produces a direct access file used by the Network 
Access Method (NAM) to perform the downline load of network processing units (NPUs). 

• NPU Dump Analyzer (NDA). This utility produces readable listings from dump files 
produced when NAM dumps NPUs. 

• PIP Dump Analyzer (LISTPPM). This utility program converts binary records from the 
peripheral interface package (PIP) memory dump file into a report listed in byte format. 

• Application Interface Program (AD?) Trace. This utility produces a trace file of the 
messages transferred between an application program and NAM. The information 
contained in this trace can be useful in tracking network problems and in debugging 
application programs. 

• Network description files. Network description files are used by the Transaction Facility 
(TAF) to describe user access characteristics defined by terminal definition directives. 

• IAF stimulator. The IAF stimulator is a collection of programs that artificially loads the 
system to analyze the effects of such a load on system performance and reliability. 

Other utilities used with the CDCNET network are documented in the CDCNET Network 
Operations and Analysis manual. 

NAM Initialization (NAMI) 

The NAMI utility controls the network software startup process. The network software 
consists of the NAM Subsystem and several reliable jobs (NS, CS, NVF, TVF, COLLECT) 
and network applications (ATF, IAF, TAF, RBF, MCS, PTF, QTF, ITF). The NAMI utility 
starts NAM and the programs NS, CS, NVF, TVF, COLLECT, and other applications 
desired at the site such as RBF, QTF, and ITF by submitting jobs to the input queue. The 
NAMI utility can also start the NAM CDCNET applications NETOU, NETLS, and NETFS, 
although they are usually started by a connection request. The skeletons of these jobs are 
contained on a master startup file along with parameter records containing directives 
telling the NAMI utility what parameters to substitute in the job skeletons and what jobs to 
start. Refer to the NOS Version 2 Installation Handbook for descriptions of the master 
startup file, parameter records, and job skeleton records. 

The advantage of having the NAMI utility start up the network software is that parameters 
that are common to more than one job or that change from one network startup to the next 
can be changed easily. 
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The console operator enters the procedure call NAM or NAMNOGO to call procedure file 
NAM or NAMNOGO respectively (refer to the NOS Version 2 Operations Handbook). These 
procedure files (saved under the SYSTEMX user name) contain the NAMI command, which 
calls the NAMI utility. The format of the NAMI command is: 

NAMI,p 1 ,p 2 p n . 

Pj is a parameter consisting of a keyword or a keyword equated to a value. All parameters 
are order independent. 



Pi 



Description 



GO 



MFN=filename 1 



OIN=nnn 



PW=password 1 



This parameter initiates the network startup process without operator 
intervention. 

The permanent file name of the master file to be used. Once this 
parameter is specified, subsequent network startups use this master 
file until a new master file is specified. If this parameter is omitted, 
the previously selected master file is used. The master file must 
reside on the system default family. 

The previous network invocation number (nnn) for which the 
dumps/traces will be collected during this run. If this parameter is 
omitted, the current network invocation number minus 1 is used. 

The password assigned to the user name where the master file is 
stored. If this parameter is omitted, the previously selected password 
is used. This parameter is not required if UN=NETOPS is specified. 



1. This parameter must be specified for the initial network software startup. It can be specified either on a NAMI command or by 
an operator entry using the NAMNOGO procedure. 
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Pi 



Description 



RN=recordname 2 The name of the parameter record on the master file that is used for 
this network initiation. Once this parameter is specified, subsequent 
network startups use this same parameter record until a new 
parameter record is specified. The following recordnames can be 
specified. 

recordname Description 



INIT 



MINIT 



MRECOV 



MULTI 



RECOVR 



RESTRT 



Purge existing dumps/traces, stop but do not dump 
local NPUs at network startup, and stop local NPUs 
at abnormal host termination. Use INIT for the 
initial startup of single host networks. 

Purge existing dumps/traces, stop local NPUs at 
network startup, do not take NPU dumps before 
initial loading of NPUs, and do not stop local NPUs 
at abnormal host termination. Use MINIT for the 
initial startup of multihost networks. 

Purge existing dumps/traces, do not take NPU 
dumps before initial loading of NPUs, and do not 
stop local NPUs at network startup or abnormal host 
termination. Use MRECOV for recovery startup of 
multihost networks after a failure. 
Collect dumps/traces on tape before network startup, 
take NPU dumps before initial loading of NPUs, and 
do not stop local NPUs at network startup or 
abnormal host termination. Use MULTI for the 
normal restart of multihost networks. 
Purge existing dumps/traces, do not stop NPUs at 
network startup or termination, and do not dump 
NPUs before initial load. Use RECOVR for recovery 
startup of single host networks after a failure. 

Collect dumps/traces on tape before network startup, 
take NPU dumps before initial loading of NPUs, stop 
local NPUs at abnormal host termination, and do not 
stop local NPUs before network startup. Use 
RESTRT for the normal restart of single host 
networks. 



2. This parameter must be specified for the initial network software startup. It can be specified either on a NAMI command or by 
an operator entry using the NAMNOGO procedure. 
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pj Description 



RS=appldes The 2-character application designator of the application to start up. 

(appldes can be more than two characters, but only the first two 
characters are used.) This parameter allows the specified application 
to be started when the network is already operational. It is not valid 
at network initiation. The application's startup job skeleton must 
reside on the parameter record/master file specified for this network 
initiation. 



The following applications can be specified. 

Application 
appldes Name Description 



AT 


ATF 


CS 


CS 


FS 


NETFS 


LS 


NETLS 


NS 


NS 


ou 


NETOU 


PR 


PSU 


PS 


PTFS 


QS 


QTFS 


QT 


QTF 


RB 


RBF 


PI 


FTPI 


TS 


FTPS 


TV 


TVF 


=username 3 The 


user name whe 



Automated Tape Facility 

Communication Supervisor 

CDCNET Network File Server 

CDCNET Network Log Server 

Network Supervisor 

CDCNET Network Operator Utility 

Printer Support Utility 

Permanent File Transfer Facility Server 

Queued File Transfer Facility Server 

Queued File Transfer Facility 

Remote Batch Facility 

File Transfer Protocol Interpreter 

File Transfer Protocol Server 

Terminal Verification Facility 



omitted, the previously selected user name is used. 



The first time the network startup process is executed, a permanent file is created using a 
network invocation number of 1 and parameters from the NAMI command. The initial call 
to NAMI must specify the filename, password, and username of the master file and 
parameter record to be used or the console operator must enter them using NAMNOGO. 

On subsequent network startup operations, a permanent file exists and contains the names 
of the last used master file, parameter record, and network invocation number. Parameters 
from this permanent file will be used to start up the network unless overridden by 
parameters from the NAMI command or parameters entered by the console operator using 
NAMNOGO. The NAMI command parameters take precedence over the permanent file 
parameters, and operator entries take precedence over parameters from either the NAMI 
command or the permanent file. 



3. This parameter must be specified for the initial network software startup. It can be specified either on a NAMI command or by 
an operator entry using the NAMNOGO procedure. 
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Network Dump Collector (COLLECT) 

The CO LL ECT utility is a program that produces three local files: one of the various host 
dump, trace, statistics, and list files that result from any abnormal termination of the 
network, one of any NPU dump files, and one of any MDI/MTI/NDI/TDI dump files. The 
collected files may be copied to the three local files and then purged, or copied and not 
purged. The local files will then be copied to tapes. There is also an option to purge the 
collected files without copying them to the local files. The format of the COLLECT 
command is: 

COLLECT , NIN=nnn, NOPURGE , NOSAVE . 

Parameter Description ^^ 



NIN=nnn The 1- to 3-character network invocation number that indicates the upper 
limit of the invocation numbers to be collected. All files with an NIN value 
from 1 to nnn are copied to the local file. If NIN=nnn is omitted, the default 
value is 1. 



NOTE 



NPUs that stop when the host network software terminates are dumped 
during the subsequent network invocation. Therefore, the network 
invocation number of these dumps is 1 greater than the dumps of the host 
programs taken at the time of the termination. 

NOPURGE Specifies that no purging activity will take place after the collected files are 
copied to the local files. If NOPURGE is omitted, the collected files are 
purged after they are copied to the local files. NOPURGE should not be 
specified if NOSAVE is specified. 

NOSAVE Specifies that the collection process is not performed and the files indicated 
by NIN=nnn are purged. NOSAVE should not be specified if NOPURGE is 
used. 

The COLLECT utility is automatically initiated by the network startup job (NAMI) upon 
each invocation of the network. (COLLECT may not be automatically initiated if the master 
file has been modified.) The utility receives an NIN value of the last network invocation 
number. The current network will be initiated with an incremented value of NIN. For 
example, on the fifth initiation of the network the COLLECT utility has a command call of 

COLLECT, NIN=0 04. 
and the network is initiated with an NIN of 005. 
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The CO LLE CT utility processes all dump, trace, statistics, and list files whose file names 
are in the form: 

pptsnnn 
Variable Description 



pp 


2-character product prefix. 




pp Description 




AT Automated Tape Facility 




CS Communication Supervisor 




DI,...,DR,DS,...,D9 MDI/MTI/NDI/TDI Dumps 




FS Network File Server 




IA Interactive Facility 




IN INITMDI Program 




IT Interactive Transfer Facility 




LS Network Log Server 




NI Network Interface Package 




NP Network Processing Unit 




NS Network Supervisor 




NV Network Validation Facility 




OS Network Operator Server 




PR Printer Support Utility 




PS Permanent File Transfer Facility Server 




QS Queued File Transfer Facility Server 




QT Queued File Transfer Facility 




RB Remote Batch Facility 




TI File Transfer Protocol Interpreter 




TS File Transfer Protocol Server 




TV Terminal Verification Facility 
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Variable Description 



Type of file. 

t Description 



D Dump file. 

L List file. 

S Statistics file. 

T Trace file. 



s 
nim 



Subtype 0, 1, 2, or 3 for the file. 

Network invocation number in the range 000 through 999. 



In the case of NPU dumps (pp=NP), ts is a unique hexadecimal number identifying the 
dump. In the case of DI dumps (pp = DI to DZ, or Dl to D9), ts is a unique character string 
identifying the dump. This character string is in the range from AA to 99. In the case of 
dayfile dumps, ts is DA. The files produced by the COLLECT utility each have one file with 
many records. Each dump, trace, statistics, or fist file is copied to a local file as one or more 
records, where the first record copied is preceded by a 2-word record containing the original 
file name This format enables an ITEMIZE or CATALOG of a COLLECT utility local file to 
show which collected files were copied to the local file. 

The COLLECT utility assigns each file a file name of the form: 
Form Description 



DUMPnnn For host dump, trace, statistics, or list files, nnn is the network invocation 
number from the COLLECT command. 

DUNPnnn For NPU dump files, nnn is the network invocation number from the 
COLLECT command. 

DMDInnn For DI dump files, nnn is the network invocation number from the 
COLLECT command. 

The local files are copied to magnetic tape (or other operator-assigned equipment) if the 
RESTRT or MULTI startup procedure is selected. Once the files are successfully copied, 
COLLECT will be executed again to purge the collected files. 

The COLLECT utility purges all dump and trace files without collecting them on a local file 
if the INIT, MINIT, MRECOV, or RECOVR startup procedure is selected. 
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Load FOe Generator (LFG) 

LFG is a utility program that reformats Communications Control Program (CCP) files for 
subsequent use by the network supervisor of NAM to load NPUs. LFG accepts one or more 
input files in single or multifile format and produces a single network load file (NLF) for use 
by the network supervisor. 

LFG is invoked with this command: 

LFG,p 1 ,p 2 ,p n . 

Pj is a parameter consisting of a keyword or a keyword equated to a value. All 
parameters are optional and order independent. 



Pi 



Description 



BC=nn 

BC omitted 
I=infile 

I omitted 
L=outfile 

L=0 

L omitted 
NLF=loadfile 
NLF omitted 
Z 



Z omitted 



This parameter specifies the maximum number of load service 
messages in a network load file record. It is used to optimize NPU 
loads. 1 < nn < 64. 

Same as BC=64. 

The 1- to 7-character name of the file on which the input directives 
are written. 

Same as I=INPUT. 

The 1- to 7-character name of the file on which the summary listing is 
to be written. 

Suppress the summary listing. If an error is detected an error 
message is written to file OUTPUT. 

Same as L=OUTPUT. 

The 1- to 7-character name of the network load file. 

Same as NLF=NLF. 

An input directive is contained on the command after the terminator. 
The I parameter is ignored. This eliminates the need to use a separate 
input directive file when there are only a few input directives. 

When the input directive appears on the LFG command, the first 
character following the command terminator is the separator 
character. Any character that is not used in the input directive can be 
used as the separator character. The input directive must be preceded 
by a separator and terminated by a blank, period, or the end of the 
input fine (column 72). 

For example, (slant used for separator): 

LFG, Z . / *FILE, PFILE1 , PFILE2 . 

Input directives are not contained on the command. The system uses 
the I parameter. 



16-8 NOS Version 2 Analysis Handbook 



60459300 U 



Load File Generator (LFG) 



Input Directives 

Input directives have this format: 

*FILE,filename lr filename 2 , . . . , filename n . 

An input directive begins with an asterisk followed by the directive identifier FILE and a 
string of file names. The directive identifier and file names are separated by commas. If a 
specified file is empty, LFG ignores it. LFG scans a directive until it detects a terminator or 
the end of the directive line (column 72). A directive is terminated by a blank, period, or the 
end of the line. If an asterisk is not specified, LFG assumes *FILE and proceeds to read file 
names. LFG continues to read input directives until the end of the record. 

Each file specified by filename contains a load partition or a program initiation control block 
(PICB) for LFG to reformat. These files are created by the CCP installation process (refer to 
the NOS Version 2 Installation Handbook). A load partition is any loadable software 
module that can be loaded into an NPU during one operation. For example, all of the 
software for CCP can be loaded into an NPU as one load partition. A PICB consists of a 
sequence of commands that controls the load or dump operations. For each step in a PICB 
that specifies a load operation there is a corresponding load partition. 

The names of the input files can be specified on the LFG command (Z parameter) or in a 
separate file (I==infile parameter). In either case, these files must be local to the job that 
runs LFG. LFG does not rewind the input files. 

If the input directives are written on a separate record in a batch job (I=INPUT), the job 
format is: 

ujn. 

USER , username , pas sword , f ami lyname . 

LFG, I = INPUT. 

--EOR-- 

*FILE,AFILE1, . .. ,AFILEn. ] 

*FILE,BFILE1, . . . ,BFILEn. I file INPUT 

*FILE , CFILE1 , . . . , CFILEn . J 

— EOI— 
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Network Load File 

The network load file produced by LFG is a random access file with the local file name 
specified by the NLF parameter of the LFG command. The default network load file name is 
NLF. 

Summary Listing 

The summary fisting produced by LFG is a summary of the network load file contents. The 
summary is written on the file specified by the L parameter of the LFG command. The 
default summary file name is OUTPUT. Error messages produced by LFG are also written 
on this file. The summary listing format is: 

No. Partition Name Input File Records 

1 PN1 AFILE1 3 

2 PN2 AFILE2 7 

3 PN3 AFILE3 2 

Field Description 

NO. Line number of the summary fisting. 

PARTITION Name of the load partition or PICB for LFG to reformat. 

NAME 

INPUT FILE Name of the input file on which the load partition or PICB resides. 

RECORDS Number of records in the load partition or PICB. 
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NPU Dump Analyzer (NDA) 

NDA is a utility program that produces a readable printout from the NPU dump file. The 
NPU dump file may contain one or more dump records, which are created by the network 
supervisor during the initiation or reloading of a failed NPU. NDA reports depict the state 
of an NPU at the time a dump is generated. NDA uses the following local scratch files 
during its processing: NEUFELE, ZZZZINP, and FDMP. 

NDA is accessed by a command that allows selection of: 

• Dumps from/to specific NPU macromemory addresses. 

• Listing options. 

• The input directive file. 

• The output file. 

The format of the command for the NPU Dump Analyzer is: 

NDA,p 1 ,p 2 , . . .,p n - 

Each parameter is a keyword or a keyword equated to a value. All parameters are optional 
and order independent. If a parameter is not specified, a default value is assumed. If the 
same keyword is specified more than once, the last (rightmost) occurrence of the keyword 
overrides all previous ones. Invalid or undefined parameters cause the run to terminate. 

Pi Description __^_ 

BA=addr The 1- to 6-digit hexadecimal address within the NPU macromemory 

at which the dump report begins. Default is BA=address of the actual 
beginning of the dump. This parameter is valid only if parameter 
LO=M, LO=E, or input directive 9 is specified. 

EA=addr The 1- to 6-digit hexadecimal address within the NPU macromemory 

at which the dump report ends. Default is EA=address of the actual 
end of the dump. This parameter is valid only if parameter LO=M, 
LO=E, or input directive 9 is specified. 

I=infile The 1- to 7-character name of the input directive file. If there is no 

input directive file, 1=0 (zero) must be specified. Default is I=INPUT. 

L=outfile The 1- to 7-character name of the output file. Default is L=OUTPUT. 
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Description 



LO=opt The 1- to 3-character listing option. Each character specifies a portion 

of the NPU dump to be listed; any unspecified portions are not listed. 
Default is LO=MR, if no input directive file is specified. 



opt Description 



E All NPU words in the NPU dump record (all of 

macromemory, file 1 registers, and page registers). 
Redundant lines are not suppressed. 

M Macromemory only. Redundant lines are suppressed. 

R File 1 registers and page registers only. 

NDF=npudump Local file name of the NPU dump file. The NPU dump file may 

contain multiple NPU dump records. Each record causes a separate 
NPU dump output to be generated. Default is NDF=NDF. 



Input Directives 

Input directives must be contained in a single logical record on the input directive file. Each 
directive is in 80-column format. Column 1 is reserved for a 1-character keyword that 
indicates a change in the processing rules and defines the new rule to be used for the 
following directives. Each directive containing a keyword in column 1 causes NDA to begin 
a new listing page. Any comments contained in that directive are printed as the first line of 
the new page. Columns 71 through 80 are ignored on all directives. Comments are allowed 
in columns 11 through 70 on directives that contain a 1-character keyword. 

Directive parameters are in fixed formats. The number of parameters and their respective 
columns within the directive varies with the 1-character keyword specified. Each parameter 
is a 5-digit hexadecimal value (leading zeros are required). Parameters are separated by 
either a comma or a blank. The remaining space between the last parameter and column 70 
of a directive may contain optional comments; such comments appear on the line of the 
output file preceding the information produced by the directive. 

— Comments 

The directive specifies that comments can be entered in columns 11 through 70 of this 
directive and succeeding directives until a different keyword is specified. 

1 — File 1 Register 

The 1 directive causes the contents of a specific file 1 register to be listed. Each file 1 
register is specified by its 5-digit hexadecimal address in columns 2 through 6 of the next 
directive and succeeding directives until a different keyword is specified. 

2 — Macromemory Word 

The 2 directive causes the contents of a specific macromemory word to be listed. Each 
macromemory word is specified by its 5-digit hexadecimal address in columns 2 through 6 of 
the next directive and succeeding directives until a different keyword is specified. 
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3 — Contiguous Block Data Structure 

The 3 directive causes identical data structures that are contiguously addressed in 
macromemory to be listed. Each directive contains five parameters in 5-digit hexadecimal 
format. Each parameter has a field name that is used in diagnostic messages. 



Field 
Columns Name 



Description 



2-6 



PNTR 



8-12 SIZE 

14-18 INDX 

20-24 FIRST 

26-30 LAST 



Macromemory location that contains the pointer to the first 
identical data structure. 

Size of the data structure in NPU words. 

Index value of the first data structure to be listed. The first 
identical data structure has an index value of 1. 

Number assigned to the first data structure to be listed. The next 
data structure listing is assigned the next highest number. 

Number assigned to the last data structure to be fisted. The data 
structure listing terminates when it reaches this number. 



4 — Circular Buffer Data Structure 

The 4 directive causes circular buffers to be listed in chronological order. Two types of 
buffers can be listed; fixed-length data structures and variable-length data structures. Each 
directive contains seven parameters in 5-digit hexadecimal format. Each parameter has a 
field name that is used in diagnostic messages. 



Field 
Columns Name 



Description 



2-6 



8-12 



14-18 



20-24 



FWA File 1 register location that contains the first word address of the 

circular buffer. 

OLDEST File 1 register location that contains the address of the oldest item 
in the circular buffer. 



LWA 



FLAG 



26-30 


PTRN 


32-36 


MASK 


38-42 


SIZE 



File 1 register location that contains the last word address of the 
circular buffer. 

File 1 register location used as a flag to indicate whether the buffer 
contains meaningful data. The buffer is not listed if this location 
contains zeros. 

Bit pattern that delimits a variable-length data structure. 

Mask for isolating the appropriate bits to identify the delimiter. 

Data structure size. Nonzero indicates a fixed-length data 
structure. Zero indicates a variable-length data structure. 
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For variable-length data structures, the next occurrence of a data structure is determined 
by first masking each word to isolate the bit pattern and then comparing this pattern with 
the specified bit pattern until a match is found. Listing begins at the first match and ends 
at the second match or at the oldest item found. For fixed-length data structures, the mask 
and bit pattern are not used. 

The circular buffer format starts by listing the oldest item in the buffer (specified in 
columns 8 through 12), then proceeds to the last word address (specified in columns 14 
through 18), then goes to the first word address (specified in columns 2 through 6), and 
continues to the oldest item in the buffer. 

7 — Page Registers 

The 7 directive causes the contents of the page registers to be listed. The 7 directive does 
not have parameters. 

8 — File 1 Registers 

The 8 directive causes file 1 registers to be listed in lines of 16 consecutively addressed 
registers in hexadecimal format. The 8 directive does not have parameters. However, if the 
parameter LO=E is specified on the NDA command, the selected option will be in effect. 

9 — Macromemory Words 

The 9 directive causes NPU macromemory words to be listed in lines of 16 consecutively 
addressed words in hexadecimal format. Eepetitive lines are suppressed and addressing 
continues with the next nonrepetitive line. This line is flagged with double asterisks to 
indicate the suppression. The 9 directive does not have parameters. However, if parameters 
BA=addr, EA=addr, or LO=E are specified on the NDA command, the selected options will 
be in effect. 
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A — LCB and TCB/CCB 

The A directive causes line control blocks (LCB) to be listed with their associated terminal 
control blocks (TCB) or cluster control blocks (CCB). Each directive contains seven 
parameters in 5-digit hexadecimal format. Each parameter has a field name that is used in 
diagnostic messages. 



Field 
Columns Name 



Description 



2-6 LCBP 

8-12 LCBL 

14-18 FTCB 



20-24 
26-30 



TCBL 
NTCB 



32-36 NLCB 

38-42 LCBX 



Macromemory location that contains the pointer to the first LCB. 
Size of the LCB in NPU words. 

Index value of the LCB word that contains the pointer to the first 
TCB/CCB. The first word in an LCB has an index value of (zero). 

Size of the TCB/CCB in NPU words. 

Index value of the TCB/CCB word that contains the pointer to the 
next TCB/CCB. The first word in a TCB/CCB has an index value of 
(zero). 

File 1 register location that contains the number of LCBs to be 
listed. If set to (zero), only one LCB is listed. 

Index value of the first LCB to be listed. The first LCB has an 
index value of (zero). 



The LCBs and their associated TCB/CCBs are listed vertically in columns such that any 
line of the report represents an LCB and its associated TCB/CCBs. In this format, an LCB 
and 15 TCB/CCBs can be listed in one line. If more than 15 TCB/CCBs are associated with 
the LCB, the next page lists the next 15 TCB/CCBs with the LCB column blank to indicate 
the association of these TCB/CCBs with the previous LCB. 
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Port Tables and MUXLCB 



The B directive causes port tables to be listed with their associated multiplex line control 
blocks (MUXLCBs). Only one MUXLCB can be associated with each port table. Each 
directive contains eight parameters in 5-digit hexadecimal format. Each parameter has a 
field name that is used in diagnostic messages. 



Field 
Columns Name 



Description 



2-6 PTTP File 1 register location that contains the pointer to the first port 

table. 

8-12 PTTL Size of the port table in NPU words. 

14-18 MUXP Index value of the port table word that contains the pointer to the 

associated MUXLCB. The first word in a port table has an index 
value of (zero). 

20-24 MUXL Size of the MUXLCB in NPU words. 

26-30 PTRN Bit pattern that identifies a valid MUXLCB. 

32-36 MASK Mask for isolating the appropriate bits to identify a valid MUXLCB. 

38-42 MUXID Index value of the port table word that contains the MUXLCB 

identifier. The first word in a port table has an index value of 

(zero). 

44-48 NPTT File 1 register location that contains the number of port tables to 

be listed. 

The validity of the pointer to a MUXLCB is determined by first masking the appropriate 
port table word to isolate the validating bit pattern and then deternuning if the specific bit 
pattern is present. If the MUXLCB pointer is invalid, MUXLCB is not hsted. 

The port tables and their associated MUXLCBs are hsted vertically in columns such that 
any line of the report represents up to eight port tables, each with its associated MUXLCB. 

Figure 16-1 is a sample of an NDA output file and its corresponding input directive file. 
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Figure 16-1. Sample NDA Output File (Continued) 
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Figure 16-1. Sample NDA Output File (Continued) 
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Figure 16-1. Sample NDA Output File (Continued) 
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Figure 16-1. Sample NDA Output File (Continued) 
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Figure 16-1. Sample NDA Output File (Continued) 
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Figure 16-1 . Sample NDA Output Ftte (Continued) 
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Figure 16-1. Sample NDA Output File (Continued) 
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Figure 16-1. Sample NDA Output File (Continued) 
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Figure 16-1. Sample NDA Output File (Continued) 
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Figure 16-1. Sample NDA Output File 
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NDA Output File Content 

The NDA output file (see figure 16-1) begins with a copy of the input directive file, 
reformatted for printing. The input directive file is followed by the header information, and 
then the rest of the report is printed in the same order as the input directive file. A 
description of the header information follows. 



NPU DUMP FILE = NPddnnn 



NDA, command image 



TIME 
DATE 
NPU NAME 
NPU NODE 
HALT CODE 
P REGISTER 

Header 



NPddnnn 

command 
image 

hh.mm.ss 

yy/mm/dd 

npuname 

nodeid 

halt 
preg 



hh.mm.ss 

yy/mm/dd 

npuname 

nodeid 

halt 

preg 

Description 



The name of the NPU dump record starting with NP, where dd is the 
hexadecimal dump number (00 through FF) and nnn is the network 
invocation number assigned at network startup. 

The NDA command parameters that were specified for this dump. 

Time of the dump in the form hour.minute.second. 

Date of the dump in the form year/month/day. 

The 1- to 7-character name assigned to the NPU in the network 
configuration file. 

The 2-digit hexadecimal number assigned to the NPU in the network 
configuration file. 

The 1- to 4-digit hexadecimal number for the NPU halt code. 

The NPtPs P-register contents at the time the NPU dump is generated 
in hexadecimal format. 
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NPU Dump Files 

Each NPU dump file is written as a single-record direct access permanent file when an NPU 
dump is taken. Individual NPU dump files are named NPddnnn, where dd is a unique 
hexadecimal dump number consecutively assigned in the range 00 through FF and nnn is 
the network invocation number assigned at network startup. 

Dump Interpretation 

When a halt occurs, halt codes are usually sent to the network operator controlling the 
NPU. (Halt codes are described in the CCP 3 Diagnostic Handbook.) If a halt occurs after 
loading but before completion of initialization, or the system becomes trapped in a loop 
during initialization (before the CCP header prints), dump interpretation may be necessary 
to determine which halt has occurred, or in which subroutine of the initiation section the 
program is looping. 

When interpreting the NPU dump fisting to determine the cause of a halt or loop, first 
examine the contents of memory location 30 16 . If the content of that location is nonzero, a 
halt has occurred; the halt code value is contained in that location 

If memory location 30 16 equals zero after a halt during initialization, find the address table 
that begins at fixed memory address 150 16 . The last nonzero entry in this table is the 
address of NPINTAB. (This is the table that is displayed at the end of a successful 
initialization. NPINTAB has a fixed address.) The NPISFL entry in the NPINTAB table 
contains the flags that mark the initialization subroutines that have completed ru nnin g 
when the loop occurred. 

PIP Dump Analyzer (LISTPPM) 

The peripheral interface package (PIP) Dump Analyzer (LISTPPM) is a utility program that 
converts all available PIP dump binary records on the PIP memory dump file into a report 
to be listed in byte format. The PIP PP memory dump file is created as local file ZZZZZPP 
by NAM when the operator drops the network or NAM detects fatal network errors. 

The format of the command for the PIP Dump Analyzer is: 

LISTPPM, B=pipfile,L=outfile. 

The parameters are order independent. Invalid or undefined parameters cause termination 
of the run. 

Parameter Description ^ 

B=pipfile Local file name of the PIP PP memory dump file. Default is B=ZZZZZPP. 
L=outfile Local file name of the output file. Default is L=OUTPUT. 
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AIP Trace With IAF 

The AIP trace utility produces a trace file of the messages transferred between IAF and 
NAM. This file, produced as a local file named ZZZZZDN at IAF's control point, contains 
information that can be useful in tracking network problems and in debugging application 
programs. However, the data in this file is in compressed format and hence the debug log 
file processor (DLFP) must be used to analyze the trace file. Refer to the NAM Version 1/ 
CCP Version 3 Reference Manual for details about the trace output and the use of DLFP. 

Select whether or not to use the AIP trace mode of operation when entering the DSD 
command, IAFffff, to initialize IAF. This command selects a procedure file that contains the 
IAFEX command. The T parameter on the IAFEX command determines whether or not AIP 
trace mode is to be in effect and also the number of messages to be contained on the trace 
file. The format of the IAFEX command is: 

IAFEX , T=count . 

Parameter Description 



T=count 5000 < count < 9999999. Message count specifying the number of messages 
that are to be logged on the trace file before that file is released to the 
system for processing. If T=* is specified, the trace file is processed only 
after IAF is terminated. 

T Same as T=16200. 

T=0 AIP trace mode is not selected. 

T omitted Same as T=0. 

Two procedure files are provided for use with the AIP trace, IAFTM and IAFTR. You can 
create other procedure files using different T parameters on the IAFEX command. 

IAFTM 

IAFTM is a procedure file that contains the IAFEX,T=* command, which causes the trace 
file ZZZZZDN to be processed only after IAF is terminated. The IAFTM procedure file also 
includes the commands necessary to process the ZZZZZDN trace file. Also, all messages 
logged on the trace file are written to the output file and then sent to a printer. 
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IAFTR 



IAFTR is a procedure file that contains the IAFEX,T command, which causes the trace file 
ZZZZZDN to be processed after every 16,200 messages have been transferred between IAF 
and NAM. A local file called TRACIAF is required by the IAFEX,T command in order to 
process the trace file. TEACIAF contains a command record, which is copied to the first 
record of the ZZZZZDN trace file by IAF. Trace information is then written to file ZZZZZDN, 
starting at the next record. This makes file ZZZZZDN suitable for submission as a batch 
job. The format of the TRACIAF file should be: 

ujn. 

USER, username , password, f amilyname . 



DLFP 



NOTE 



When system activity is very high, the potential exists for these problems to occur if the AIP 
trace is used: 

• If the system load remains at a very high level for a long period of time, a system hang 
due to PP saturation could occur. 

• If mass storage requirements become great, the ZZZZZDN trace file could reach track 
limit. If so, IAF would stop and wait for resources to become available. 

Both of the preceding problems are unlikely to occur in most situations. Also, the risk of 
reaching track limit can be minimized by selecting a message count on the IAFEX command 
that causes the trace file to be processed and released after the specified number of 
messages have been logged. This lowers the mass storage requirements. There are some 
problems that can only be solved by using the AIP trace. For these problems, do not 
hesitate to use the AIP trace since any risk involved is minimal. 
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Network Description Files 

The network description files describe the physical and logical configuration of hardware 
and software elements that comprise the terminal network. They are important to the 
proper functioning of the TAF and NAM Subsystems of NOS as well as the QTF/PTF 
applications if the file transfer capability with NAM is a desired feature. Depending on 
which subsystems a site has, from one to three such files may be used on a single 
mainframe. Each file has the following unique function and/or construction. 4 



File Name Description 



LCFFILE and Local configuration file and network configuration file that must be 
NCFFILE present if NAM is used. They are created by the network definition 

language processor (NDLP) from source text prepared according to 
specifications given in the Network Definition Language Reference 
Manual. 

NCTFi 5 Network description file that must be used if the Transaction Facility 

(TAF) is used. The site analyst prepares this file according to the 
following specifications. 

Under standard operating conditions, the network subsystems expect LCFFILE and 
NCFFILE to be permanent, direct access files stored under user name NETADMN. These 
files may be private with read permission given to user name NETOPS, semiprivate, or 
public. LCFFILE and NCFFILE are binary files created by NDLP; NCTFi is a text file 
composed of terminal definition directives. The text file is interpreted by code in common 
deck COMCRTN to produce tables used by TAF during system operation. TAF expects 
NCTFi to be a direct access public file stored under the SYSTEMX user index (377777 g ). 

A terminal definition directive can be up to 90 columns but only columns 1 through 72 are 
interpreted. Any line containing an asterisk in column 1 is a comment and is ignored. 



4. For information about network description files associated with the CDCNET network, refer to the CDCNET Network 
Operations and Analysis manual. 

5. i is the network file identifier as specified in the TAF configuration file (refer to the TAF Reference Manual). 
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The following format shows the terminal definition directive. No embedded blanks are 
allowed. 

/ terminalname , p^ , p 2 , . - - , p n - 
Parameter Description 



terminalname 



The 1- to 7-character alphanumeric name that uniquely identifies the 
terminal; terminalname must be specified. When NCTFi is created, 
terminalname must agree with any automatic login user name. 



Ei_ 



TT=*ID 



DB=db 

IS=stat 

RS=n 
UA=n 

US=n 



Description 



Terminal type identified by terminal operator entry. 

A TAF terminal is defined with the previous parameter, as 
well as the following, which are unique to TAF. 

The 2-character data base name to be used by the terminal. 

Initial on/off status of the terminal; stat can be either ON or 
OFF. Default is ON. 

Data base read security (from to 7). Default is 0. 

24 bits defining the user argument area (from to 
77777777 8 ). Default is 0. 

Data base update security (from to 7). Default is 0. 



To use the permanent file and queued file transfer capability with NAM, you must specify 
certain NDL statements when creating the local configuration file, as follows: 

• Specify application statements with the PRU and NETXFR parameters for applications 
QTF, QTFS, PTF, and PTFS (QTFS and PTFS require the RS parameter). 

• Specify the MXCOPY parameters for these applications depending on expected usage. 
Suggested values are MXCOPY=4 for QTF, and MXCOPY=14 for QTFS, PTF, and PTFS. 

• Specify the INCALL and OUTCALL statements as needed. 

Refer to the Network Definition Language Reference Manual for NDL statement formats. 
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IAF Stimulator 

The IAF stimulator is a collection of central memory and peripheral processor programs 
that enters a hypothetical work load (called a session or script file) into the system to 
analyze the effects of such a load on response time and system reliability. 

The IAF stimulator consists of a central memory program (STIMULA) and a peripheral 
processor program (ITS). 

To use the stimulator: 

1. Create the hypothetical load (refer to Session File Construction later in this section). 

2. Process these jobs using stimulator commands at the system console (refer to Session 
File Processing later in this section). 

Multiple IAF stimulator sessions are described under Multiple Sessions later in this section. 
Errors that can occur while the IAF stimulator software is in use are described in the NOS 
Version 2 Operations Handbook. 
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STIMULA 

STIMULA is an internal stimulator that enters a hypothetical work load into the system 
through IAF. The stimulator software communicates directly with IAF using a channel. 
Therefore, 2550s are not used. Only interactive terminals can be analyzed with STIMULA; 
it does not check out other communication devices or paths. The format of the command is: 

STIMULA, I=f ilename . 

Parameter Description 

filename Local file to be used as the session file. If not specified, the initial K display 
(refer to figure 16-5) requests the session file name. 



Session File Construction 

A session (or script) file is an indirect access permanent file containing the hypothetical job 
load that is to be analyzed by the IAF stimulator. A session file consists of a group of 
records; each record is a session and contains a hypothetical job that is composed of the 
following required entries made in the order shown: 

1. Begin each internal stimulation session with the entry ANSWERBAC. (Other first lines 
may be used; however, ANSWERBAC is used in most cases.) 

2. Enter each session entry on a separate line or card. 

3. After ANSWERBAC, enter a family name entry, a user name entry, and a password 
entry. You may place these entries on the same line if they are separated by commas. 

4. Specify the terminal commands and data. 

5. End each session with the command BYE so that the login of the next session is 
performed correctly. The HELLO command must not be used unless it is followed by a 
blank line. 

Figures 16-2, 16-3, and 16-4 are examples of session files and figure 16-5 shows the initial K 
display. 
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ANSWERBAC 

FAMILY 

USERNAM 

PASSWRD 

CATLIST 



DAYFILE 
BYE 

*E-0-R* 
ANSWERBAC 
FAMILY 
USERNAM 
PASSWRD 
CATLIST 



DAYFILE 
BYE 

*E-0-R* 
ANSWERBAC 
FAMILY 
USERNAM 
PASSWRD 
CATLIST 



DAYFILE 
BYE 

*E-0-R* 
STASKO 50 
OLD, FILE 
LIST 
LIST 

*E-0-R* 
$TASK1 30 
OLD, FILE 1 
LIST 
LIST 

*E-0-R* 
STASK2 20 
OLD , FILE2 
LIST 
LIST 



*E-0-F* 



\ Session record 



\ Session record 



\ Session record 



\ Task record 



1 

} Task record 



1 

[ Task record 



Figure 16-2. Sample Session File With Tasks for Use by STIMULA 
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STOP 



D= -C**3 
D=C**3 



ANSWERBAC 

FAMILY 

USERNAM 

PASSWRD 

CHARGE (7159, 73KDFA) 

> 1 

FORTRAN 
NEW, MATH 

10 PROGRAM MATH 

20 1 CONTINUE 

30 READ 10, A 

40 IF(A.EQ.O) 

50 B=A*A 

60 C=SQRT<B) 

70 IF(A.LT.O) 

80 IF(A.GT.O) 

90 PRINT 20, A 

100 PRINT 30, B 

110 PRINT 40, D 

120 GO TO 1 

130 20 FORMAT ( 

140 30 FORMAT ( ' 

150 40 FORMAT (' 

160 10 FORMAT (F15. 3 

170 END 

> > 
RUN 
2.0 
0.0 

25 PRINT 50 

155 50 FORMAT ( 

LIST 

RUN 

1.0 

2.0 

3.0 

4.0 

0.0 

160 10 FORMAT (F12.1) 



} Source line input 



A EQUALS ' ,F15.3) 
A SQUARED = ' ,F15.3) 
A CUBED = ',F15.3) 



1 

} Program input 

J 



ENTER VALUE ' ) 



Figure 16-3. Sample Session for Use by STIMULA (Continued) 
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LIST 

RUN 

10.0 

11.1 

13.3 

0.0 

160 10 FORMAT (F12. 3) 

LIST 

RUN 

15.555 

40.0 

50.0 

0.0 

LIST 

RUN 

10.0 

20.0 

30.0 

40.0 

0.0 

ENQUIRE, T 

DAYFILE 

BYE 



Figure 16-3. Sample Session for Use by STIMULA 
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ANSWERBAC 

FAMILY , USERNAM, PASSWRD 

BASIC 

OLD 

TESTB 

LIS, 294 

RUN 

01000 

REPLACE 

BYE 

*E-0-R* 

additional 
sessions 

*E-0-F* 



Figure 16-4. Sample Session File for Internal Stimulation 



K. STM 

hh.mm.ss. yy/mm/dd. CDC NETWORK OPERATING SYSTEM 

MID=AA NOS version 

STIMULA 

PARAMETER DESCRIPTION 

F = STPTEST SESSION FILE NAME (1-7 CHARACTERS). 

UI = 137 USER INDEX (0-377777B) . 

N = 1 NUMBER OF FILE ON SESSION FILE (0-377777B) 



ENTER K.GO TO BEGIN PROCESSING OF SESSION FILE. 



Figure 16-5. STIMULA K Display (Left Screen) 
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Dynamic Login 

If each of the terminals to be analyzed is logged into the system with a unique user name 
and password, a unique session record for each terminal is stored in central memory at the 
IAF stimulator control point. Thus, a large amount of central memory could be unavailable 
to other components of the system. To alleviate this condition, dynamic login is possible, 
whereby one session record is generated with a unique user name and password that are 
dynamically translated into unique user names and passwords for each terminal at run 
time. The generated user names and passwords are then validated via system validation 
files. The format choices are: 

usemame$$$ 

or 

username$$$ ,password$$$ 

Parameter Description . 



username User name; 1 to 4 alphabetic characters, 
password Password; 1 to 4 alphabetic characters. 

$ Special symbol 12/8/6 (6-bit display code 76 8 ), 1 (6-bit display code 34 8 ) 

punch; that is, 12/8/6 punch in one column and 1 punch in next column. 



NOTE 



The $ denotes the special symbol previously described, not the character 
itself. The $ character is translated into the IAF stimulator terminal 
numbers at run time. 



Example: 

P$$$,P$$$ is translated into P000,P000 for the first terminal, into P001,P001 for the second 

terminal, and so forth. 
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Optional Think Time Specification 

Think time is the number of seconds that each line is delayed before it is sent through the 
interactive system. A random think time can be specified with a session file command. The 
format of the command is: 

> number 

Parameter Description 

number Think time (octal): number < 177 8 . 

To return the terminal to the initial think time (refer to figure 16-6), enter this command: 



K. STM 

hh.mm.ss. yy/mm/dd. CDC NETWORK OPERATING SYSTEM 
MID=AA NOS version 

STIMULA 

PARAMETER DESCRIPTION 



NUMBER OF TERMINALS TO STIMULATE (1-310B) . 
LINE SPEED IN CHARACTERS /SECOND (1-1000). 
INPUT SPEED IN CHARACTERS / SECOND (1-1000) . 

THINK TIME DELAY IN SECONDS (0-127). 

RANDOM THINK TIME INCREMENT (A POWER OF 2 0-64) . 

THINK TIME WILL VARY BETWEEN TT AND TT+TI . 

NUMBER OF TERMINALS ACTIVATED EVERY AD SECS (1-64) 

ACTIVATION DELAY IN SECONDS (1-127). 

NUMBER OF TIMES TO REPEAT STIMULATION (0-31) . 

LOGOUT DELAY (0-4095) . 
OUTPUT RECOVERY (ON OR OFF) . 
LOPP ON SESSION FILE (YES OR NO) . 



NT 


= 


310B 


LS 


= 


15 


IS 


= 


15 


TT 


— 


10 


TI 


= 


8 


AC 


_ 


4 


AD 


= 


10 


RC 


= 





LD 


= 





RO 


= 


ON 


LF 


= 


NO 



Figure 16-6. STIMULA Parameters (Left Screen) 
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Task Definitions 

A task is a predefined set of interactive commands designated by a task name and a task 
usage parameter. Tasks can be called throughout a session, and the task usage parameter 
is used to determine which task is the next most eligible task (that is, the task to be called 
next). 

An T character (6-bit display code 70 8 ) in the session calls the next most eligible task in the 
session file, which is determined by the following equation. 

Total initiations of taski 



(Total initiations of all tasks) (Task usage parameter for taski) 

For each taskj defined in the session file, the IAF stimulator calculates f i; and the task with 
the smallest f value is the next most eligible task. Multiple T characters are permitted on 
one line and are treated as if they occurred on separate lines. For example, T T T calls the 
first three most eligible tasks, where eligibility is recalculated after each initiation of a task. 
If a task is called and the IAF stimulator cannot determine the next most eligible task in 
the time allotted, the first task defined in the session file is used. 

Tasks for the IAF stimulator are denned in the session file as task records following the 
session records. Tasks are not permitted in the file before session records. The tasks should 
be defined in descending order according to the task usage parameter. This facilitates use of 
the first task defined as the default next most eligible task in situations where the IAF 
stimulator fails to calculate the next most eligible task on time. 

The first line in a task record must be: 

Stask nnn 

Parameter Description 



$ Denotes the beginning of a new task (character position 1). 

task The 1- to 6-character task name. 

nnn Task usage percentage; < nnn < 100 (character positions 8, 9, 10). The task 

usage percentages of all tasks in the session file must total 100. 

The last line in a task record must be a i character (6-bit display code 71 8 ), which returns 
control to the calling session. An example of a session file with tasks defined is shown in 
figure 16-2. 
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Session File Processing 

The IAF stimulator software is used to process the interactive session file following this 
procedure: 

1. Ensure that an IAF stimulator entry is present in the EQPDECK and that the IAF 
stimulator has an ON status (refer to the section 3, Deadstart Decks). ON status must 
be set before IAF is active at a control point. If the status has been changed to OFF, 
idle IAF and then set ON status and reactivate IAF. The IAF stimulator entry must be 
on a channel that is not used by any other equipment that currently has a status of ON. 

2. Use DSD to activate the IAF stimulator. 

Enter STMffiF, where fiff is to 4 alphanumeric characters. This entry calls a 
procedure file STMffiF, which must be a permanent indirect access file stored under the 
system user index (377777 8 ). The procedure file STM is called when you enter STM. 
The IAF stimulator is invoked by a STIMULA command within the STM procedure file. 
The IAF stimulator requests the K display. 

3. Enter K,STM. Figure 16-5 appears on the left screen. 

4. Enter the session file parameters individually as listed in the following format column 
or as a group on the same line in the format. 

K . F=f ilename , UI=userindex , N=n , GO . 

Format Default Description 

KF=filename None filename is the indirect permanent file name of the 

session file. 

K.UI=userindex userindex is the user index of file filename. The 

default family is assumed. 

KN=n n is the number of files to be skipped on file 

filename before data is read from the session file; 
range is from to 377777 8 . 

K.GO None Indicates to the IAF stimulator that all the 

parameters have been entered or that none are to be 
entered. 

Figure 16-6 appears on the left screen. 

5. To display the mixed mode parameters, enter: 

KK. 

Figure 16-7 appears on the right screen. Then, enter: 

K. MIXED. 

Figures 16-8 (left screen) and 16-9 (right screen) appear. 
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K DISPLAY COMMANDS 
GO BEGIN STIMULATION. 

MIXED DISPLAY PARAMETER MATRIX AND ENTER MIXED MODE 
PARAMETER ASSIGNMENT. 



Figure 16-7. STMULA K-Display Commands (Right Screen) 

6. Enter the parameters (refer to figure 16-6) individually as listed in the following format 
column or as a group on the same line in the format. 

K.NT=n,LS=s,IS=s,TT=n,TI=i,AC=m,AD=d,RC=n,LD=d,RO=o,GO. 

Enter any mixed mode parameters (refer to figure 16-9) before the GO entry. 



Format 



Default 



Description 



KNT=n 



KLS=s 



Current EST n is the current maximum number of terminals on 
value which the Interactive Subsystem is initialized. It 

must be less than or equal to the number specified 
in the EST entry; the range is from 1 to 1000 8 . 



15 



KIS=s 



KTT=n 



K.TI=i 



KAC=m 



15 



10 seconds 



s is the line speed in characters per second at which 
you want to run the terminals; the range is from 1 
to 1000. Any value above 60 characters per second 
causes a line speed of approximately 60 characters 
per second. If many terminals (600 8 , for example) 
are run, the maximum realizable line speed is 
determined by the overhead of 1TD and ITS. The 
worst case can be determined by checking the 1TD 
cycle time dayfile message, which is issued when 
IAF is dropped. 

s is the typing speed in characters per second at 
which you want to run the terminals; the range is 
from 1 to 1000. 

n is the number of seconds (think time) that each 
line is to be delayed before it is sent to IAF; the 
range is from to 127 seconds. 

i is the number of seconds by which the think time 
will vary; the range is from to 64 and i must be a 
power of 2. If i is nonzero, the think time varies 
between n (the value of TT) and n+i. 

m is the number of terminals that are to be logged 
in every d seconds (the value of AD); the range is 
from 1 to 64. The AC and AD parameters provide a 
method to stagger the I/O commands and data to 
IAF. 
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Format 



Default 



Description 



K.AD=d 

K.RC=n 
KLD=d 

KRO=o 



10 seconds 



seconds 



ON 



d is the number of seconds of delay time until the 
login of another terminal is allowed; the range is 
from to 127 seconds. 

n is the number of sessions that will be executed for 
each terminal; the range is from to 31. 

d is the number of seconds of delay time after a 
logout is completed until the next login of the 
terminal is allowed; the range is from to 4095 
seconds. 

When RO=ON, the output from IAF is recovered on 
file STIMOUT. The format of this file is: 



6ft 


47 


35 


23 


ii 







■ , 


k 


t 


t 




t 




t 










r 











Terminal Each byte is an ASCII character if less 
number. than 4000 8 ; otherwise, it is the 
running-second time. 

When RO=OFF, the output is not recovered. 

K.LF=o NO When LF=NO, looping occurs on the session 

assigned to the terminal. When LF=YES, the 
subsequent session is the next session in the session 
file. 

KMIXED No mixed Specifies that mixed mode parameter assignments 

mode are required for specific input sessions. This 

parameters command displays the stimulation parameter 
entered matrix (refer to figure 16-8) whose values can be 

changed as described in the right screen K display 

(refer to figure 16-9). 

K.MX=s 1 -s 2 , Current Mixed mode input. s x is the number of the first 

ttys,ls,is, value session to be changed, and s 2 is the number of the 

tt,ld,rc last session to be changed. s 2 is optional; the default 

is s v (Refer to figure 16-9 for other parameter 

descriptions.) 
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Format 



Default Description 



KCF=filename 


None 


K.+ 


None 


K- 


None 


KGO 


None 



Matrix change file. Indirect access file filename is 
accessed for mixed mode input directives, and must be 
saved under the same user index as the session file. 

Page matrix display forward to the next screen. 

Page matrix display backward to the previous screen. 

Indicates that all parameters have been entered. 
Stimulation is initiated. 



Example: 

K.MX=2-4,3,30,30, ,,1. 

Three terminals will be assigned to sessions 2, 3, and 4. The line speed and input speed for 
these terminals will be 30 characters per second. The think time and logout delay will not 
be changed from the current value. The terminals will have a repeat count of 1. 



K. s ™ 

hh.inm.ss. yy/iran/dd. CDC NETWORK OPERATING SYSTEM 
MID=AA NOS version 

STIMULATION PARAMETER MATRIX 

NUMBER OF TTYS ASSIGNED 200 

MAXIMUM TTYS PERMITTED 200 



CF = CHANGE 



MATRIX CHANGE FILE (1-7 CHARACTERS) 



SCRPT 

1 
2 
3 
4 
5 



TTYS 

40 
40 
40 
40 
40 



LS 



IS 



15 
15 
15 
15 
15 



15 
15 
15 
15 
15 



TT 

10 
10 
10 
10 
10 



LD 



RC 









Figure 16-8. Parameter Matrix (Left Screen) 



60459300 U 



Network Utilities 16-45 



IAF Stimulator 



K DISPLAY COMMANDS 

GO BEGIN STIMULATION. 
+ PAGE DISPLAY FORWARD. 
PAGE DISPLAY BACKWARD. 

MIXED MODE PARAMETERS 

MX=SCRIPT, TTYS , LS , IS , TT , LD , RC . 

SCRIPT SCRIPTS WHICH THE PARAMETERS WILL AFFECT. 
SCRIPT (N) OR SCRIPT (N) -SCRIPT (N+X) . 

TTYS NUMBER OF TTYS ASSIGNED TO SCRIPTS. 

LS LINE SPEED ASSIGNED TO SCRIPTS. 

IS INPUT SPEED ASSIGNED TO SCRIPTS. 

TT THINK TIME ASSIGNED TO SCRIPTS. 

LD LOGOUT DELAY ASSIGNED TO SCRIPTS. 

RC REPEAT COUNT ASSIGNED TO SCRIPTS. 

NULL PARAMETER WILL KEEP CURRENT VALUE. 
CF=XXX CHANGE MATRIX VIA PREDEFINED PARAMETERS. 

XXX = PERMANENT FILE CONTAINING CHANGE DIRECTIVES IN FORMAT 
MX=SCRIPT , TTYS , LS , IS , TT , LD , RC . 



Figure 16-9. Mixed Mode Parameters (Right Screen) 

Multiple Sessions 

Each session on the session file is allocated to each terminal line. When each session has 
been allocated, the IAF stimulator goes to the first session and reallocates the session to the 
next group of terminals. This procedure is repeated until all the terminals are allocated to a 
session. If a repeat count is not designated (RC parameter), the line is shut off when the 
session is finished. When the session completes, the repeat count is checked. 

The repeat count corresponds to the number of sessions to be executed on a given terminal. 
The current session is completed, and the LF parameter determines the next session to be 
executed. If LF=NO, the session currently assigned to the terminal is repeated. If LF=YES, 
the next session in the session file is executed. For example, if the repeat count is 4, the 
session currently assigned to the terminal is repeated four times (LF=NO), or the next four 
sessions on the session file (with repetition, if necessary) are executed (LF=YES). 

Parameter Output Format 

The parameter information (shown in figure 16-10) is placed on the output file for printing 
upon completion of the IAF stimulator run (refer to Session File Processing earlier in this 
section). 
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STIMULATOR PARAMETERS- 












SESSION FILE NAME- 






F= 




SSCC1 


USER INDEX- 






UI= 




1 


NUMBER OF THE FILE- 






N= 




1 


NUMBER OF TERMINALS- 






NT= 




100B 


LINE SPEED- 






LS= 




30 


INPUT SPEED- 






IS= 




10 


THINK TIME- 






TT= 




3 


RANDOM THINK TIME- 






TI = 







ACTIVATION COUNT- 






AC= 




1 


ACTIVATION DELAY- 






AD= 




1 


REPEAT COUNT - 






RC= 




4 


LOGOUT DELAY- 






LD= 







OUTPUT RECOVERY- 






RO= 




ON 


LOOP ON SESSION FILE- 






LF= 




NO 


MATRIX CHANGE FILE- 






CF= 






STIMULATION PARAMETEE 


MATRIX 




SCRPT TTYS LS 


IS 


TT 


LD 


RC 


1 22 30 


10 


3 





4 




2 21 30 


10 


3 





4 




3 21 30 


10 


3 





4 




NUMBER OF TTYS 


ASSIGNED = 


54 




MAXIMUM TTYS PERMITTED = 


54 




TASK CALLS COMPLETE 


DESIRED % 


ACTUAL % 


TASKO 848 818 




50. 


000 




49.970 


TASK1 509 492 




30. 


000 




29.994 


TASK2 340 327 




20. 


000 




20.035 


TOTALS 1697 1637 




100. 


000 




99.999 


DEFAULT TASK CALLS = 




15 









Figure 16-10. Output Statistics 
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Postprocessing 

The postprocessing of the IAF stimulator output is accomplished by reading the file 
STIMOUT and sorting the data according to terminal number. Use the DEMUX command 
to do this. As DEMUX sorts STIMOUT, it assigns an encounter number (starting at 1) to 
the output from each terminal session. DEMUX includes this number in the final line of 
each sorted terminal session output. The data for each terminal is separated by a page eject 
and an end-of-line indicator. The terminal data appears as it would on a terminal page. If 
the ASCII character on the STIMOUT file is 4000 8 or greater, the lower 10 bits are 
assumed to be time of a carriage return or the first character of output. If STIMOUT will be 
processed at a later time, you should save it. 

Figure 16-11 shows an example of output from DEMUX 



ANSWERBAC 

***** TTT TTT 

***** TTT .TTT 

WELCOME TO THE NOS SOFTWARE SYSTEM. 

COPYRIGHT CONTROL DATA 1978, 19XX. 

yy/mm/dd.hh.mm.ss. 



END OF THE LINE- 

(Page Eject) 
ANSWERBAC 



Figure 16-11. Postprocessing Example 

In figure 16-11, *****TTT.TTT is optional output, and the n in the previous listing is the 
decimal encounter number. 
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The format of the DEMUX command is: 

DEMUX, p-^Pj, .. . ,p n . 

Pi is either a keyword or a keyword equated to a value. 



Pi 



Description 



I=filename 
I omitted 
NR 

NT=n 

0=filename 

O omitted 

SL=terminalnumber 



Name of the file containing IAF stimulator data. 

Same as I=STIMOUT. 

Specifies that the input and output files are not to be rewound. 

Number of terminals to be processed (0 < n < 512). This tells 
DEMUX how much memory to allocate to process the input file. 
If no post radix is specified, octal base is assumed. 

Name of the file to receive translated session output. 

Same as 0=OUTPUT. 

Selective terminal number (within the range specified by the 
NT=n parameter) to be processed, terminabaumber is the 
terminal number minus 1 in the T display. If SL is omitted, all 
terminals within the range specified by the NT=n parameter are 
processed. 

Specifies that the time of each carriage return and first output 
character is written with the processed data. Subtracting the two 
time values gives the response time. The time values can also be 
used to correlate data between each terminal's input and output. 
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Example 1: 

Following is an example of a procedure file called when STM. is entered at the console. It 
executes the STIMULA command and performs postprocessing of the IAF stimulator 
output. The procedure file must be stored as a permanent indirect access file under the 
system user index (377777 8 ). 



.PROCSTM. 

STIMULA . 

DEMUX, NT=310,O=NOS,T. 

GET , RESB/UN=usemame . 

RESB. 

ASSIGN, NE, TRASH. 
DFD, OP=I , L=TRASH . 



Procedure file name. The IAF stimulator is executed. 

RESB is a user-created program to analyze DEMUX 
output. 



The system dayfile is dumped to null equipment. 



REQUEST (T) idle IAF Processing stops until IAF is idled. Also, ASSIGN,STM,2 

DFD, OP=l . should be performed. 

A partial dayfile dump is performed that includes IAF 
statistics. 

ATTACH , ERRDATA/M=W . Output of all failing jobs is copied to output. 

COPYEI , ERRDATA, OUTPUT . 
EVICT , ERRDATA . 
RETURN , ERRDATA . 
EXIT. 
DIS. 

In the previous procedure file, output from failing jobs is copied from the file ERRDATA. In 
order for ERRDATA to contain this information, another procedure file is necessary to 
collect data on jobs that fail and place this data in ERRDATA. This procedure file (called 
ERRCHEK in the next example) should be called in the following manner after each IAF 
stimulator session. 

GET , ERRCHEK/UN=username . 

ERRCHEK. 
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Example 2: 

Following is an example of this procedure file. 

.PROC,ERRCHEK*I. 
IF,EF.NE.O,EXIT. 



DISPLAY, EF. 
ASSIGN, MS , OUTPUT . 
ENQUIRE, A. 
DAYFILE. 

ATTACH , ERKDATA/UN=username , M=W, NA . 

SKIPEI,ERRDATA. 

REWIND, OUTPUT. 

COPYEI , OUTPUT , ERRDATA . 

RETURN , OUTPUT , ERRDATA . 

COMMENT. FAIL* ******** *********** 

COMMENT. FAIL* *********** ******** 

COMMENT. FAIL******************** 

COMMENT. FAIL* ******************* 

COMMENT. FAIL** ********** ******** 

COMMENT. FAIL* ********* ********** 

COMMENT . FAI L ******************* * 

COMMENT. FAIL* ********** ********* 

COMMENT. FAIL********* *********** 

COMMENT. FAIL* ******** *********** 

COMMENT . FAI L ******************* * 

COMMENT. FAIL* ************* ****** 

COMMENT. FAIL* ******************* 

EXIT. 

REQUEST , FAIL . ERRCHECK FAILED . . 



If certain jobs normally cause compilation 
errors, additional procedure should be 
included to allow for these special cases. 

Data is gathered on which program and 
which statement caused the error. 



This data is placed on file ERRDATA, which 
is used later during postprocessing. 



These comments warn users that failures 
have been encountered. 



If serious problems have been encountered, 
DIS could be brought up at this point. 



ENDIF,EXIT. 
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Care should be taken when comparing response times between different versions of the 
operating system with the IAF stimulator. Other factors may have a significant impact on 
response time. Be aware of these factors: 

• The entire parameter set should be the same for each IAF stimulator run. The rate of 
activation of terminals, for example, can significantly impact response time. 

• The hardware configurations must be identical. If an attempt is made to measure small 
differences, all devices that cannot be restored to their original state (normally 
temporary devices) should be deadstarted and fully initialized. 

• If the possibility exists that permanent files have been destroyed, these files should be 
restored before each run. This can be accomplished easily by maintaining a copy of all 
required files under a user name not used during the stimulation. A procedure file can 
then be called to restore the files before each IAF stimulator run. This is important 
when stimulation loads are causing abnormal job failures. A REPLACE shortly after an 
unexpected abort may cause incorrect information to be written, for example. 

• Job processing must be the same for each IAF stimulator run. When many terminals 
are to be analyzed, random job failures may be overlooked. These failures may, 
however, affect the entire results of the IAF stimulator run. To minimize this problem, 
it is necessary to check errors in all sessions quickly and easily. This can be done by 
using the procedures described earlier in this section. 

By using the preceding techniques and procedures and observing the restrictions, it becomes 
easier to use the IAF stimulator to check performance and reliability and to obtain 
meaningful data from the system. 
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Introduction 

Five utility processors maintain the NOS permanent file system. They control the processes 
of dumping and loading permanent files, cataloging permanent files in the system and on 
backup storage (archive) files, copying archived files to a job as local files, and releasing the 
disk space of files that reside on tape or cartridge alternate storage. 

The utility processors are overlays under the control of the permanent file supervisor (PFS). 
PFS processes the parameters in the utility command and loads the correct processing 
overlay. The overlays interact with the permanent file utility (PFU) routine, which manages 
the catalogs, permits, data allocation on a device, and the data transfer between the device 
and the overlay. Figure 17-1 is an overview of this procedure. 



PERMANENT FILE SUPERVISOR (PFS) 

LOADS THE CORRECT OVERLAY FOR 
PERMANENT FILE PROCESSING 




PFOUMPt 

OVERLAY FOR 
DUMP 



PFLOAD1 

OVERLAY FOR 
LOAO 




PFCAT 1 

OVERLAY FOR 
DEVICE 
CATALOG 




PFAH1 

OVERLAY FOR 

ARCHIVE 

FILE 

RAMA6ERENT 



PFWTt 

OVERLAY FOR 

DISK 
NANA6ENENT 




PERMANENT FILE UTILITY (PFU) 

PERFORMS VARIOUS UTILITY 
FUNCTIONS FOR THE PERMANENT 
FILE UTILITY OVERLAYS 



Figure 17-1. Functional Overview of the Permanent File Utility Overlays 
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The names and functions of the permanent file utilities follow. Detailed information about 
the call and operation of each utility is contained in this section. 

Utility Description 

PFATC Produces a cataloged directory of file information derived from an archive file. 

PFCAT Produces a cataloged directory of file information derived from catalog tracks 

on a permanent file device. 

PFCOPY Copies files from an archive file to a job as local files. 

PFDUMP Dumps files from a permanent file device to an archive file. Files created by 
this dump can be reloaded by the PFLOAD utility. 

PFLOAD Loads files from an archive file (created by PFDUMP) to a permanent file 
device. 

PFREL Releases disk space of files that reside on tape or cartridge alternate storage. 



Utility Description Terminology 

The descriptions of the permanent file utilities in this section include some terms you 
should be familiar with. These terms are defined next. 

Archive File 

All or some of the permanent files accumulated on mass storage can be dumped to a backup 
tape (or other type of backup medium) to protect the files from loss in case of a device 
malfunction or to free a device for temporary use during preventive maintenance. Each 
dump of permanent files is made to a file called an archive file; each permanent file dumped 
is called an archived file. Each archive file is a multirecord file in which each logical record 
is an archived file. If two or more dumps are made on one type of backup device, these 
archive files constitute a multifile archive file (refer to figure 17-2). 

The archive file can be loaded back onto the permanent file system as a whole or in part and 
can also be used to generate reports. The individual archived files can be referenced for 
selective use. Refer to each utility for more information on how it uses the archive file. 

Alternate Storage 

The storage of permanent file data on external media other than mass storage (such as 
magnetic tape, MSE, or optical disk) is called alternate storage. When a file resides on 
alternate storage, the PFC entry and permits must reside on disk but the disk space 
occupied by the file data can be released. 
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PERMANENT 
FILE SYSTEM 



FILE1 
FILE2 
FILES 

FILE* 
FILES 



DUMP A 



DUMPS 



ARCHIVE FILE A 
-{3 LOGICAL RECORDS) 



F1LE1 



EOR 



u 



ARCHIVE FILE B 
{Z LOGICAL RECORDS) 



FILEZ 



EOR 



FILE 3 
EBR 



EOF 



FILE 4 



EOR 



FILE 5 



EOR 



EOF 



EOF 



MULTIFILE 
ARCHIVE 
FILE 



Figure 17-2. Example of Multifile Archive File Structure 



Destaging and Staging Files 

The process of copying file data to alternate storage from disk residence is called destaging 
the file. File destaging to either tape or optical storage is initiated by using the PFDUMP 
utility; destaging to MSE is initiated by using the SSMOVE utility. 

The process of restoring file data to disk residence from a copy on alternate storage is called 
staging the file. File staging is initiated by entering an ATTACH, GET, OLD, or APPEND 
command for a file that is not currently disk resident. 
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User Index 



A 17-bit user index is associated with each user name created on the user validation file. 
This index is entered through MODVAL (refer to User Validation in the Administration 
Handbook) with the UI parameter on the user name input directive 
(/username,UI=userindex) or MODVAL, by default, supplies the next available index. 

Whenever you submit a job, the related user index is placed in the control point area along 
with the user name and other parameters that link hardware, files, and job. The permanent 
file manager (PFM) identifies the master device and catalog track for you by performing two 
masking operations that involve the user index and two sets of device parameters (device 
mask and number of catalog tracks) obtained from the mass storage table in central 
memory resident (CMR). One operation correlates the rightmost octal digit in the user index 
(bits through 2) with the bit settings of the device mask for each device in the 
configuration to determine which device is your master device (refer to the device mask 
definition next). The other operation performs a logical AND between the remaining portion 
of the index and the number of catalog tracks on the master device to determine which 
track contains your catalog (refer to the catalog track definition later in this section). 

The lower 3 bits (rightmost octal digit) of the user index are used to group users together 
into subfamilies. Each permanent file family (refer to the definition of family later in this 
section) consists of eight subfamilies, subfamily through subfamily 7. Any user whose 
index ends in belongs to subfamily 0, any user whose index ends in 1 belongs to subfamily 
1, and so forth. The concept of subfamily is important in a Mass Storage Extended 
Subsystem (MSE) environment. 
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Device Masks 

Two types of device masks exist for each device, the device mask (or primary mask) and the 
secondary mask. 

Device Mask 

The device mask is an 8-bit quantity used to identify the group of users that has the 
particular device as its master device; that is, it identifies the device that contains the 
group's file catalogs, all its indirect access files, and possibly some or all of the group's direct 
access files. (Assigning direct access files to a device is described next, under Secondary 
Mask.) 

Kbit i is set in the mask of the device, any user whose index ends in i has this device as a 
master device. 

Example 1: 

The device identified by the mask 261 8 is the master device for any user whose index ends 
in 0, 4, 5, or 7, because these bits are set in the mask. 



7 




5 


4 











1 





1 


1 











1 



2 e 1 

When masks are assigned at device initialization time, the following rules must be observed. 

• Within a family, the sum of all the device masks must be exactly 377 8 . 

• Each bit position (0 through 7) must be set exactly once for the masks of the devices in 
one family. 

Example 2: 

For a family of three devices, 221 8 , 042 g , and 114 8 are valid device masks because their sum 
is 377 8 and each bit is accounted for only once. 

10010001= 221 8 
00100010 = 042 8 
01001100= 114 fl 



11111111 



377 c 



If the sum of the device masks is less than 377 8 , then at least 1 bit is not set in any of the 
device masks. Any user index ending in such a bit-position value does not reference a device. 
Therefore, if such a user tries to create a permanent file, the system issues an error message. 
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Example 3: 



For a family of four devices, 142 8 , 020 8 , 010 8 , and 204 8 are not valid device masks because 
their sum is less than 377 8 . Any user whose index ends in would have no master device 
and could not create a permanent file. 



110 


1 


= 142 g 


10 





= 020 8 


1 





= oio 8 


10 


1 


= 204 8 


11111 


1 1 


= 376 g 



If the sum of the device masks is greater than 377 8 , then at least 1 bit is set for more than 
one device mask. Any user index ending in such a bit-position value references more than 
one master device. 

Example 4: 

For a family of four devices, 212 8 , 106 8 , 040 8 , and 021 8 are not valid device masks because 
their sum is greater than 377 8 . Bit 1 is set twice, which indicates that any user whose index 
ends in 1 would have two master devices, one with mask 212 8 and one with mask 106 8 . 



10 


1 





1 


= 212 8 


10 





1 


1 


= 106 8 


10 











= 040 8 


1 











1 = 021 8 



11111111= 401 8 

1 

It is a necessary but not sufficient condition that all masks for one family total 377 8 . It is 
possible, but not allowable, that in one family the device masks total 377 8 but some bit is 
set in more than one device mask. 

Example 5: 

For a family of three devices, 261 8 , 115 8 , and 001 8 are not valid device masks because bit 
is accounted for three times and bit 1 is not set at all. Any user whose index ends in would 
have three master devices. Any user whose index ends in 1 would have no master device. 



10 11 








1= 261 8 


10 


1 


1 


1= 115 8 











1= OOlg 


1111 


1 


1 


1= 401 8 

1 
1 
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Secondary Mask 

The secondary mask of a device is an 8-bit quantity used to identify groups of users who can 
place direct access files on the particular device. If bit i is set in the secondary mask of the 
device, any user whose index ends in i can place direct access files on this device. 

Example 1: 

A device whose secondary mask is 072 8 can contain direct access files of any user whose 
index ends in 1, 3, 4, or 5, because these bits are set in the mask. 



S 4 3 1 

1 1 1 1 



Direct access files may or may not reside on a master device, depending on the user index 
and secondary mask. The appropriate bit must be set in the secondary mask of the device 
on which the user's direct access files are to reside. A direct access file is placed on a valid 
device with the most space available unless the user specifies a particular device. 

Example 2: 

The following situations occur for a device whose mask is 26 1 8 and secondary mask is 072 8 . 

7 6 4 6431 



10 11 1 









1 


1 


1 





1 






This device is the master device for, and can contain direct access files of, any user 
whose index ends in 4 or 5 (bits 4 and 5 are set in both the device mask and the 
secondary mask). 

This device is the master device for, but cannot contain direct access files of, any user 
whose index ends in or 7 (bits and 7 are set in the device mask but not in the 
secondary mask). 

This device is not the master device for, but can contain direct access files of, any user 
whose index ends in 1 or 3 (bits 1 and 3 are set in the secondary mask but not in the 
device mask). 

This device is not the master device for, and cannot contain direct access files of, any 
user whose index ends in 2 or 6 (bits 2 and 6 are not set in either the device mask or 
the secondary mask). 



60459300 U 



Permanent File Utilities 17-7 



Introduction 



Existing files can be denned as direct access permanent files, regardless of the secondary 
mask, for user indexes above 377700 8 (AUIMX). However, PFLOAD will enforce the 
secondary mask check when loading these files. Direct access files for MSE subfamily user 
indexes (377760 through 377767 8 ) are always loaded to their master devices regardless of 
previous residence or secondary mask values. 

There are no restrictions on the number of devices in one family that can have the same 
bits set in the secondary mask or regarding the sum of the secondary masks for devices in 
the same family. The secondary mask must be a number between and 377 8 . 

Example 3: 

For a family of three devices, 000, 13 1 8 , and 326 8 are possible secondary masks. Any user 
whose index ends in 0, 3, 4, or 6 can place direct access files on the device whose secondary 
mask is 13 1 8 . Any user whose index ends in 1, 2, 4, 6, or 7 can place direct access files on 
the device whose secondary mask is 326 8 . No user can place direct access files on the device 
whose secondary mask is 000. Any user whose index ends in 4 or 6 can place direct access 
files on two devices, and any user whose index ends in 5 cannot use direct access files. 












0= ooo 8 


1 





110 


1= 131 g 


1 1 





10 1 


10= 326 8 


1 1 





111 


11= 337 8 


1 




1 
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Mass Storage Table 

The configuration of mass storage devices currently available to the system is defined by the 
CMR mass storage table (MST). Each logical device in this configuration has an entry in 
this table. Refer to the NOS Version 2 Systems Programmer's Instant for the MST format. 

Catalog Track 

Your catalog track is a track on your master device containing the catalog entries (definition 
follows) that define and specify the location of each permanent file you have created. Users 
are assigned by groups to catalog tracks according to their user index and number of catalog 
tracks on their master device. 

The number of catalog tracks on a device is established when the device is initialized or by 
default. Default values are: 

Type of Device Default Number of Catalog Tracks 

Extended memory (DE) 4 

834 (DD) 40 8 

836 (DG) 40 8 

844 (DI, DJ, DK, DL) 40 8 

885-11/12 (DM, DQ) 10 8 

885-42 (DB) 10 8 

887 (DF, DH) 10 8 

895 (DC) 10 8 

819 (DV, DW) 10 8 

5832/5833/5838 (EA-EH) 10 8 

9853 (DN) 10 8 
DDP path to extended memory (DP) 4 

Private device 1 

The number of catalog tracks is always a power of 2; the maximum number is 200 8 . 
Therefore, the possible numbers of catalog tracks on a device are: 

1, 2, 4, 10 8 , 20 8 , 40 8 , 100 8 , 200 8 
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Reducing these numbers by 1 produces the following numbers, referred to as track masks. 

0, 1, 3, 7, 17 8 , 37 8 , 77 8 , 177 8 

The track masks in binary form are: 

o 

l 

l l 

ill 

1111 

11 ill 

ill ill 

l ill ill 

These track masks, except the first one, have all bits set; when bits 3 through 9 of the user 
index for a particular user are ANDed with the track mask for his/her master device, the 
user's catalog track number on that device is produced. 

Example: 

For a family of two devices, the following device masks, number of catalog tracks, and track 
masks are valid. 

Device Number of Corresponding 

Device Mask Catalog Tracks Track Mask 



1 221 8 or 10 010 001 40 8 40 8 -l=37 8 or 11 111 

2 156 8 or 01 101 110 20 8 20 8 -l=17 8 or 1 111 



377 8 11 111 111 

A user whose index is 14224 8 is assigned device 1 as his master device because bit 4 (last 
digit in 14224 8 ) is set in the device mask for device 1. Therefore, device 1 contains this 
user's catalog track. 

The binary form of 14224 8 is 001 100 010 010 100. 

Therefore, the catalog track number for this user is 22 8 (on device 1) because the logical 
AND of bits 3 through 9 of the user index with the track mask for device 1 is: 

100010010 
AND 11111 



1 1 or 22 8 

The end of a catalog track is indicated by an end-of-information (EOI) on the device. All 
catalog tracks are linked in the track reservation table (TRT) and appear as one logical 
chain. When catalog entries exceed the logical track, a continuation track is reserved at the 
end of the catalog track chain in the track reservation table. The disk linkage bytes for the 
overflowed track point to the continuation track. 
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Permanent File Catalog Entry 

Files in the permanent file system are referenced by dynamically updated permanent file 
catalog (PFC) entries on the catalog tracks of master devices. Whenever you create a 
permanent file, a catalog entry that specifies the characteristics of the file (access 
information about the file and its location) is entered on a catalog track on your master 
device. When you modify the file, the PFC entry is updated to reflect the modification. 

The format of the PFC entry follows. The 4-character names to the right of each word are 
symbols used by the system to reference the PFC entry fields. These symbols are defined in 
common deck COMSPFM. 



59 



53 



47 44 41 



35 



23 



17 



wordO 

1 

2 

3 

4 

5 

6 

7 

10 

11 

12 

13 

14 

15 

16 

17 



filename 



file length 



permit random index 



access court 



| mode | ef | ec | dn 



optical disk address 



or | ss | ac t§;i§;§i 



caftags 



T 



user index 



track 



creation date and tone 



data modification date and time 



last access date and time 



control modificatiort date and time 



utility control dale and lime 



T 1 



file password 



expiration date 



cat 



wm 



cartridge alt storage address 



access categories 



charge number 



project number 



IT 



project number 



fie seo, number 



tape alt storage VSN 



user control word 



reserved for installation 



FCFN, FCU 

FCLF, FCBT, FCBS 

FCRI.FCCD 

FCAC, FCMD 
FCCT, FCAM. FCEF, 
FCEC. FCEO. FCAO 
FCOA.FCKD 
FCRS, FC8R. FCFS, 
FCAP. FCUO 

FCPW, FCXD 

FCAF. FCAT, FCAA 

FCAL.FCFC 

FCCN 

FCP1 

FCP2 

FCTF.FCTSsFCTV 

FCUC 

FCIW 



Field 



Word Bit(s) Description 



filename 





userindex 





file length 


1 


track 


1 


sector 


1 


permit random 
index 


2 


creation date and 
time 


2 


access count 


3 



59-18 Permanent file name. 

17-0 User index of file creator. 

59-36 Length of the file in PRUs. 

23-12 Beginning track of the file. 

11-0 Beginning sector of the file. 

59-36 Random disk address of first permit sector. 

35-0 yymmddhhmmss in octal when this file was first 
entered on the permanent file system. The year 
(yy) is biased by 70. 

59-36 Total number of times this file has been 
accessed. 
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Field 



Word Bit(s) Description 



data modification 
date and time 



ct 



35-0 yymmddhhmmss in octal when data in this file 
was last modified. The year (yy) is biased by 70. 
For direct access files this field is updated only 
when the file is attached in a modifiable mode. 

59-54 File category: 

Private. 

1 Semiprivate. 

2 Public. 



mode 



53-48 Mode of access for semiprivate and public files: 

Write, read, execute, append, modify, 
and/or purge. 

1 Read and/or execute. 

2 Append. 

3 Execute. 

4 Negate previous permission. 

5 Modify. 

6 Read and/or execute, allow modify. 

7 Read and/or execute, allow append. 

10 Update. 

11 Read and/or execute, allow update. 



ef 



47-45 Error flag: 

No error. 

1 EOI changed by recovery. 
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Field 



Word Bit(s) Description 



ec 



44—42 Error code: 



No error. 

1 Error in file data. 

2 Error in permit entries for file. 

3 Error in data and permit entries. 

4 Error in file length. 
5-7 Reserved. 



dn 



last access date 4 

and time 

optical disk address 5 



control modification 
date and time 



41-36 Device number (1 through 77 8 ) of the device on 
which the direct access file resides if other than 
the user's master device. If the file resides on 
the master device, dn is 0. 

35-0 yymmddh hmm ss in octal when this file was last 
accessed. The year is biased by 70. 

59-36 Relative address of the file on optical disk. The 
complete address consists of this relative 
address, the version number of the archive file, 
and the optical disk VSN. The version number 
and VSN are specified in the cartridge alternate 
storage address field in word 10 8 . 

35-0 yymmddhhmmss in octal when this file's control 
information (catalog entry and permit record 
data) was last modified. 
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Field Word Bit(s) Description 



pr 6 59-57 Preferred residence 1 for this file: 

1 File locked to disk (PR=L specified by file 
owner with validation). 

2 Disk residence preferred (PR=D specified by 
file owner). 

3 Cartridge alternate storage (MSE or optical 
disk) residence preferred (PR=M specified 
by file owner). 

4 No preferred residence (PR=N specified by 
file owner). 

5 Tape alternate storage residence preferred 
(PR=T specified by file owner). 

br 6 56-54 Backup requirement 2 for this file: 

1 No backup copy of file required. (BR=N 
specified by file owner). 

2 Two backup copies required (BR=Y specified 
by file owner). 

3 One backup copy required (BR=MD 
specified by file owner). 

ss 6 53-48 Subsystem code for this file: 

Null Subsystem. 

1 BASIC Subsystem. 

2 FORTRAN Subsystem. 

3 FTNTS Subsystem. 

4 Execute Subsystem. 

5 Batch Subsystem. 



1. Refer to Permanent File Commands in the NOS Version 2 Reference Set, Volume 3 for details on the PR and BR parameters. 

2. Refer to Permanent File Commands in the NOS Version 2 Reference Set, Volume 3 for details on the PR and BR parameters. 
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Field 



Word Bit(s) Description 



ac 



utility control date 
and time 



file password 
expiration date 



6 47 Alternate CATLIST permission: 3 

Alternate users cannot obtain CATLIST 
information about the file (AC=N specified 
by file owner). 

1 Alternate users can obtain CATLIST 
information about the file (AC=Y specified 
by file owner). 

6 35-0 yymmddhhmmss in octal set by PFM and PF 

utilities and used by PFDUMP in determining 
whether to dump the file when the OP=M option 
is specified. This field is updated when the data 
modification date and time field is updated or 
PFDUMP finds a file busy (attached in 
modifiable mode). This ensures that the file is 
selected on subsequent dumps even if the data 
modification date and time field does not change. 

7 59-18 Optional password. 

7 17-0 yymmdd in octal when this file's password 

expires. The year is biased by 70. 



3. Refer to Permanent File Commands in the NOS Version 2 Reference Set, Volume 3 for details on the AC parameter. 



60459300 U 



Permanent File Utilities 17-15 



Introduction 



Field 



Word Bit(s) Description 



caflags 



10 59-48 Cartridge alternate storage flags; refer to section 

11, MSE, for details. 



Flag 



Bit 



Description 



AFLOK 59 Interlock flag used during 

the process of destaging a 
file to MSE or optical disk: 

indicates that either the 
file is not in the destage 
process or the file was 
modified during the destage 
process. If you attempt to 
set an alternate storage 
address with the SETASA 
request, the request is 
rejected. 

1 indicates the file is in the 
destage process and is 
unmodified. After the 
destage process is complete, 
you can enter a SETASA 
request to set an alternate 
storage address in the PFC 
entry for the file. The 
SETASA request also clears 
this flag. 

AFFRE 54 Free up cartridge flag: 

means do not remove file 
from cartridge. 

1 means remove file from 
cartridge. 
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Field 



Word Bit(s) Description 



caflags (Continued) 



FJag_ 



Bit 



Description 



AFTMP 53 Temporary error flag: 

indicates that no 
temporary error conditions 
have been detected. 

1 indicates that a temporary 
error condition prevented 
the MSE image of the file 
from being staged to disk. 
After the error condition is 
detected, this flag is cleared 
so that the file staging can 
be retried on the next 
request for the file. 

AFVEK 52 Verification flag: 

means that if the 
cartridge alternate storage 
address is not zero, a 
successful stage/ destage 
operation has occurred and 
system control errors should 
not be encountered. 

1 means that the PFC entry 
containing the cartridge 
alternate storage address 
was reloaded and a stage 
attempt has not yet been 
made. If a system control 
error is detected, the 
probable cause is that the 
cartridge alternate storage 
address is obsolete, probably 
because an obsolete dump 
tape was used during the 
reload. 
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Field 



Word Bit(s) Description 



caflags (Continued) 



Flag 



Bit 



Description 



AFPDE 50 Data error flag: 

means that no 
unrecoverable read errors 
have been detected. 

1 means that an 
unrecoverable read error 
prevented the MSE image of 
the file from being staged to 
disk. 

AFPSE 49 System control error flag: 

means that no system 
error conditions have been 
detected. 

1 means that a system error 
condition prevented the 
MSE image of the file from 
being staged to disk. 
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Field 



Word Bit(s) Description 



caflags (Continued) 



Flag 



Bit 



na 



48 



Description 



Reserved. 



cat 



cartridge alt. 
storage address 



10 41-36 Cartridge alternate storage type: 

File resides on disk only. 

1 Reserved. 

2 File has a copy on MSE. 

3 File has a copy on optical disk. 

10 35-0 Cartridge alternate storage address: 

An MSE or optical disk copy of the 

file does not exist. 

Nonzero Depends on the value of cat. If cat 
is 2, specifies the location of the 
beginning of the file on MSE. If cat 
is 3, specifies both the packed VSN 
of the optical disk containing the 
archive file (bits 23-0) and the 
version of the archive file (bits 
35-24). The optical disk address 
field in word 5 contains the relative 
address of the file copy within the 
archive file. 



al 4 



11 38-36 File security access level: 

Access level 0. 

1 Access level 1. 



7 Access level 7. 



4 The 8 access levels and 32 access categories are referenced by names defined by or in micros in system common deck 
COMSMLS. The default names are LVLO through LVL7 for access levels and CATOO through CAT31 for access categories. Each 
site determines what the access levels and categories mean, and can change the corresponding names to clarify that relationship. 
For example, access level 3 may be defined as meaning secret, so the name for access level 3 can be changed from LVL3 to 
SECRET. If any of the COMSMLS micros are changed, all decks calling COMSMLS must be reassembled. 
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Field 



Word Bit(s) Description 



access categories 



charge number 


12 


59-0 


project number 


13-14 


59-0 


taflags 


15 


59-4! 



11 31-0 File security access categories: 

Each bit indicates whether the file has the 
corresponding access category as part of its 
category set. Bit corresponds to access 
category 0; bit 1 to access category 1, and so 
forth. A file's category set can be any, all, or 
none of the 32 available categories. 

Charge number to which this file is billed. 

Project number to which this file is billed. 

59-48 Tape alternate storage flags; refer to section 12, 
Tape and Optical Disk Alternate Storage, for 
details. 

Flag Bit Description 

TFLOK 59 Interlock flag used during the 
destaging of a file to tape: 

indicates that either the file 
is not in the destage process or 
the file was modified during the 
destage process. If you attempt 
to set an alternate storage 
address with the SETASA 
request, the request is rejected. 

1 indicates the file is in the 
destage process and is 
unmodified. After the destage 
process is complete, you can 
enter a SETASA request to set 
an alternate storage address in 
the PFC entry for the file. The 
SETASA request also clears 
this flag. 

TFACS 56 File on ACS cartridge tape. 

TFCTS 55 File on either ACS or CTS 
cartridge tape. 

TFLIF 54 File on tape recorded in LI 
format. 

TFESV 53 Data error on secondary VSN 
flag. 
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Field 



Word Bit(s) Description 



taflags (Continued) 



Flag Bit Description 

TFEPV 52 Data error on primary VSN 
flag. 

TFSVN 51 Secondary VSN not accessible 
flag. 

TFPVN 50 Primary VSN not accessible 
flag. 

TFSVS 49 Secondary VSN exists flag: 

indicates a secondary VSN 
does not exist. 

1 indicates a secondary VSN 
does exist. 

TFVEK 48 PFLOAD verification flag: 

means that if the tape 
alternate storage VSN pointer 
is not zero, a successful 
stage/destage operation has 
occurred and system control 
errors should not be 
encountered. 

1 means that if the PFC entry 
containing the tape alternate 
storage VSN pointer was 
reloaded and a stage attempt 
has not yet been made. If a 
system control error is detected, 
the probable cause is that the 
tape alternate storage VSN 
pointer is obsolete, probably 
because an obsolete dump tape 
was used during the reload. 
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Field 



Word Bit(s) Description 



file seq. number 

tape alt. storage 

VSN 



user control word 



15 41-24 Sequence number of the file on the dump tape 

produced by PFDUMP. 

15 23-0 Tape alternate storage VSN pointer in the 

following format: 

12/cc, 12/nnnn 

where cc is any two alphanumeric characters 
and nnnn is a 12-bit binary integer. 

The tape's primary VSN is cc followed by nnnn 
converted to a decimal integer in the range of 
0000 to 4095 with leading zeros. The secondary 
VSN, if it exists, is derived by adding 5000 to 
the primary VSN. 

16 59-0 User control information. 
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Track Reservation Table (TRT) 

Every device in a permanent file system has a label track (usually track 0) that contains a 
label sector describing the device (family name, device mask, secondary mask, location of 
permit information, catalog information, and indirect files) and a number of physical record 
units (PRUs) containing the track reservation table (TRT). The TRT describes the physical 
layout of data on the device and is the key to allocating information on the device. 

The TRT contains single-word entries that define track linkage and bit-setting controls for 
those tracks (refer to figure 17-3). Each word has four 12-bit linkage bytes and three sets of 
4-bit control settings that match the 4 bytes (refer to figure 17-4). Linkage format is given 
in figure 17-5. 

The numbering of the 12-bit linkage bytes or cells corresponds to the numbering of tracks 
on the device, with the first track starting at 4000. The entry in a cell references the next 
cell and its associated track. This next track either continues the information or starts a 
new sequence depending on the first-track bit setting. 

Figures 17-3 and 17-4 show a sequential linkage of tracks (in figure 17-4, from track 4000 to 
track 4001 to 4002 to 4003). This numerical sequence is purely illustrative. The linkage 
could just as well have been: 



4000 



4002 



4015 



4012 





59 


47 


35 


23 11 7 3 






Track Link 


Track Link 


Track Link 


Track Link 


P 


i 


r 










t 




t I 


T 


















\ 

To 
TRT 


\ 

next 
word 



















Figure 17-3. Track Reservation Table Word 

Each track reservation table word contains the following entries: 



Entry 



Track Link 



l 
r 



Description 



Address of the next track that is a logical continuation of this file. (The 
track links are shown as sequential within a word, but this is not a 
requirement.) 

Bit settings for identifying the first track of a preserved file (permanent 
file chain or queued file). 

Bit settings for establishing interlock of a track. 

Bit settings for track reservation. 
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The first group of control settings (bits 8 through 11) is used to identify those tracks that 
begin a sequence of file information. If any one of these bits is set, the associated track is 
the first track of a chain that may extend across a number of tracks. This chain can be a 
direct access file, an indirect access file data chain, a catalog chain, a permit chain, a system 
dayfile, or a queued file. 

The second group of control settings (bits 4 through 7) is used to interlock tracks. If any one 
of these bits is set, the associated track cannot be accessed as long as this bit remains set. 
Whenever a file is accessed, the system automatically interlocks the catalog track containing 
the file. The interlocking capability is necessary because PFM may be processing several 
requests directed at one file simultaneously. Without interlock, these requests could overlap. 

The third group of control settings (bits through 3) is used to identify reserved tracks. A 
track is reserved either because it has data written on it or it is a flawed track. A flawed 
track is removed from availability by reservation at deadstart, by subsequent initialization, 
or by reformatting with the FORMAT utility for 844 devices. 

Figure 17-4 shows matching of four reserve track bit settings with corresponding track link 
bytes. The same correspondence holds for the interlock bits (4 through 7) and the first-track 
bits (8 through 11). 




Figure 17-4. Bit Settings for Track Link Bytes 
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LINKAGE 
BYTE 

T 



OCTAL INDICATION 
OF THE NEXT WORD 
IN THE CHAIN 



INDICATES WHICH 
BYTE IN THE WORD 
IS BEING REFERENCED 



4XXX = I O XXX XXX * Y Y 



L 



IF THIS BIT IS SET, THIS IS A LINK BYTE ; 
IF IT IS NOT SET, THIS IS THE LAST TRACK 
IN THE CHAIN AND THE NUMBER IS THE SECTOR 
NUMBER OF A SECTOR CONTAINING THE EOI (END 
OF INFORMATION). 



EXAMPLE : THIS ILLUSTRATES THE SEQUENTIAL LINKAGE 



4053 



►4075 



•4077- 



•0100 



BYTE BYTE I BYTE 2 BYTE 3 

4050 4051 4052 4053 



WORD 12 6 








4075 






U 




1 00 


OO III 1 1 ««•- 


















1 1 




I 




BYTEO 
4074 


BYTE 1 BYTE 2 
4075 4076 


BYTE3 

4077 




W0RDI7 8 




4077 




0100 










1 00 


0< 




1 1 1 


h 




J 


I 


3 1 1 1 


i 


I 

LAST 

SECTOR 

(EOI) 




i l 























Figure 17-5. Linkage Format With Example 
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Family 

A family is a collection of from 1 to 63 logical devices identified by a 1- to 7-character family 
name. Users and their files are grouped together according to the family available to them. 
Usually, the grouping is within the configuration on which these users normally run jobs. 
However, a family can be connected to any configuration and still relate to the same users 
and files. 

An auxiliary device, identified by a 1- to 7-character pack name, is a single device that is not 
included in any family and can be accessed by validated users from any family. An auxiliary 
device provides users with an alternative to the master devices for storing and accessing 
permanent files. Use of auxiliary devices enables an analyst to provide special sets of 
permanent files for selected users or for designated periods. For example, an auxiliary 
device could be made available from 1200 to 1700 every day for any properly validated user. 

A permanent file device is either a member of a family or an auxiliary device. Permanent 
files on a family device are accessed through user catalogs contained on a master device 
within the family. The user catalogs that reference permanent files on an auxiliary device 
are contained on that device; that is, an auxiliary device is a self-contained entity. 

Families and auxiliary devices are defined at initialization time by the PF entry in the 
EQPDECK or by the DSD INITIALIZE command. Normally, a configuration has one family 
available. Additional families can be defined or introduced (on removable devices) in the 
same configuration. If more than one family is available in a configuration, you supply the 
family name at login or on the USER command. The default family is used if no family 
name is supplied. 5 Any job can change its associated family name by using the USER 
command to specify the new family name. 6 A system origin job can use the FAMILY 
command to change the family name associated with the job. If the FAMILY command is 
included in any nonsystem origin job, the job aborts. 

The FAMILY command is valid for unsecured systems only. 

The format of the FAMILY command is: 

FAMILY, familyname. 

Parameter Description 

familyname The 1- to 7-character name of a family of permanent file devices. If omitted, 
the default family name specified at deadstart is assumed. 



5. The default family name is specified at deadstart time with the EQPDECK FAMILY entry and cannot be changed dynamically. 

6. Refer to the IPRDECK entry in section 2, Deadstart Decks, and to the DSD command ENABLE. SECONDARY USER 
COMMANDS in section 5, DSD Commands: also refer to the USER command in the NOS Version 2 Reference Set, Volume 3. 
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If an alternate family of permanent file devices is introduced into the configuration without 
a user validation file, the job to create the user validation file could include a FAMILY 
command to identify the alternate family. If the familyname parameter is omitted, the 
default family name is assumed. 

Figure 17-6 is an example of a typical set of configurations. 
Example: 

One configuration with six permanent file devices [equipment status table (EST) ordinals 6 
through 13] is identified as system A. Three of the devices are grouped into a family with 
the name FAMA. They have device numbers 40, 41, and 42. The remaining three EST 
ordinals have been defined as removable. This means that the system will allow family and 
auxiliary devices to be introduced on this equipment during system operation. 



SYSTEM A 




SYSTEMS 


EST DEVICE 
ORDINAL NUMBER 




EST DEVICE 
ORDINAL NUMBER 

c — ^ \ 




. y . 




6 S H 40 




FAMA 


•8- 

,- • 

f c — ^» 


AUXILIARY 


■e- 

• 8 - 

c — ^ 


FAMB 




- 8 


DEVICES 
AUX1 


- 8 




EQUIPMENT 
DEFINED AS i 
REMOVABLE 


•8 

• 8 
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R 
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REMOVABLE 




l V J 




*> — ^ 



Figure 17-6. Example of Families in Two Configurations 
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A second configuration with six permanent file devices is identified as system B. Three of 
the devices have been grouped into a family with the name FAMB. They also have device 
numbers 40, 41, and 42. The remaining three pieces of equipment have been defined as 
removable. 

Two auxiliary devices are available to both systems. These have the pack names AUX1 and 
AUX2. 

Users of FAMA would normally run jobs on system A. Users of FAMB would normally run 
jobs on system B. 

The removable equipment on system A (EST ordinals 11, 12, and 13) could be used for two 
purposes: 

• To mount auxiliary devices AUX1 and/or AUX2 as required by users of FAMA. If users 
of FAMB need access to AUX1 and/or AUX2, these auxiliary devices will have to be 
mounted on some combination of equipment defined by EST ordinals 11, 12, and 13 on 
system B. 

• To mount FAMB devices when they are no longer accessible through system B. In this 
case, users of FAMB will have to transfer their access to system A. This transfer could 
involve moving disk packs from equipment defined by EST ordinals 6, 7, and 10 in 
system B to equipment defined by EST ordinals 11, 12, and 13 in system A, or system A 
could already have alternate channel connections to equipment defined by EST ordinals 
6, 7, and 10 in system B but would define them as EST ordinals 11, 12, and 13 in its 
own system. If the users of FAMB access their files through system A, they submit 
their jobs to system A or dial into system A using a different telephone number. (They 
would dial the same number if communication gear is switched.) The ISF command 
must be used to make the validation file from FAMB available on system A. 

Assuming that access to all of FAMB is transferred from system B to system A, the new 
array of system A will be as illustrated in figure 17-7. System A now has two families, 
its original default family FAMA and the newly attached family FAMB whose devices 
now have the EST ordinals 11, 12, and 13. Its device numbers (40, 41, and 42) remain 
the same. The device numbers happen to be the same as those used within FAMA but 
device numbers provide uniqueness only among devices within a family. Accordingly, 
total uniqueness of a device is provided by the combination of family name and device 
number. 

Users of FAMA will still be able to access their files without specifying the family name 
since FAMA is still the default for system A However, users of FAMB will have to 
specify to system A that they belong to FAMB either at login or on the USER command. 

If another equipment (EST ordinal 14) were available on system A, either auxiliary 
pack AUX1 or AUX2 could be mounted on it and users from either family could access 
files on this pack. 
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Figure 17-7. Example ofTransferring Family Access 



Summary File 

Any of the permanent file utilities can create a summary file containing utility processing 
information. The summary file is a machine-readable version of the information available 
on the utility output file. This summary file is used as input by the utility GENPFD; 
however, a site-written utility could use this information to generate selection directives for 
permanent file utility operations such as destaging files and releasing disk space, or to 
obtain permanent file statistics for billing, and so forth. 

The summary file consists of a prefix table followed by a system identifier block, a device 
status block, an archive file identifier block, CIR entries block(s), and PFC entries 
block(s). The format of the prefix block allows you to use the CATALOG command (refer to 
the NOS Version 2 Reference Set, Volume 3) to display some information about the contents 
of the summary file and the environment in which the summary file was created. 

Additional block types may be added in future releases of NOS; thus, any site-written utility 
should be coded to skip (and ignore) any block types other than the ones documented here. 

The format of the summary file follows: 
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7700B 



Prefix Table (all utilities) 
59 
Word 
1 
2 
3 
4 
5 
6 
7 

10 
16 



kl 



35 



0016B 



record name 



yy/am/dd 



hh.n 



,ss 



coanent 



17 



Field 



record name 



Word Bits Description 



59-18 



yy/mm/dd 


2 


59-0 


hh.mm.ss 


3 


59-0 


comment 


10-16 


59-0 



Name of the record recognized by common deck 
COMCSRT. The default value is the current date in 
the format yymmdd. You can use the SR parameter 
to specify the record name, if desired. 

Start date of the utility. 

Start time of the utility. 

Text indicating the utility name, the family or pack 
name (if applicable), and the system title from CMR 
words SYTL through SYTL+3. 
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System Identifier Block (all utilities) 













1 
2 

3 

4 

7 

10 


59 




35 17 




Word 


SYSTEH 


len 






utility name 


max block length 






yy/mm/dd 






hh.aw.ss 






system title (SYTL) 
















11 
12 
13 






system version <SVNL> 






tittiiiniiinuiiutm 


packed date and time 






nimiiiiiimimiiniiiiiiminmuit 


system level 




Field 


Word 


Bits 


Description 




len 







0-17 


Length of this block excluding the control word 
(13 8 ). 


utility name 


1 


59-18 


Name of the permanent file utility that created the 
file. 


max block lengt 


h 1 


17-0 


Maximum length of subsequent data blocks (1000 8 ). 
This value can be used by a program interpreting 
the file to allocate memory. 


yy/mm/dc 




2 


59-0 


Start date of the utility. 


hh.mm.ss 




3 


59-0 


Start time of the utility. 


system title 


4-7 


59-0 


Contents of CMR words SYTL through SYTL+3. 


system version 


10-4 


59-0 


Contents of CMR words SVNL and SVNL+1. 


packed date anc 


I 12 


35-0 


Start date and time of the utility in packed format. 


time 










system level 


13 


17-0 


Value of tag NOSLVL denned in COMSVER. 
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Device Status Block (PFCAT, PFDUMP, PFLOAD, and PFREL utilities only) 

59 47 35 23 17 11 8 5 

Word 
1 

2 

3 
4 



OEVSTAT 


ten 


f amity/pack name 


iimillllllillfi 


user nmt 


llllllllllllllll) 


type 


track size 


tracks av 


tracks 


// 


u 


dn 


amimmtmtnuiuni 


net 


/////// 


SIR 


dm 



Field 



len 







Device Status entry n 
(n < 63 8 ) 



Word Bits Description 



11-0 



family/pack 


1 


59-18 


name 






user name 


2 


59-18 


type 


3 


59-48 


track size 


3 


47-36 


tracks av 


3 


35-24 


tracks 


3 


23-12 



Length of this block excluding the control word. 
Block length = (number of device status 
entries)*2+2. 

Name of the family or auxiliary device to which the 
information pertains. For an auxiliary device, there 
will be only one device status entry and the device 
number will be zero. 

User name if this block is for a private auxiliary 
device; otherwise, this field is 0. 

Equipment mnemonic from the device's EST entry. 

Number of sectors per track. This field allows 
computation of the space occupied by direct access 
files. 

Number of tracks available on this device. This 
field is used in disk space release processing. 

Number of tracks on this device. 
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Field 



Word Bits Description 



u 

dn 

net 

sm 

dm 



3 
3 
3 

4 
4 



8-6 Number of units on this device. 

0-5 Device number. 

32-24 Number of catalog tracks on this device. 

7-4 Secondary device mask. 

0-3 Device mask. The residency device number of a file 

that resides on a master device can be determined 
by matching the file's user index to a device mask. 



Archive File Identifier Block (PFATC, PFCOPY, and PFLOAD utilities only) 

59 35 17 

Word 

1 

2 

3 



ARCFILE 


len 


family name 


imiiiiiiiitun 


pack name 


iimiiiumnn 


!/////////////////////// 


packed date and time 



Field 



Word Bits Description 



len 

family name 

pack name 

packed date and 
time 



17-0 Length of this block excluding the control word (3). 

1 59-18 Name of the family to which the archive file belongs. 

2 59-18 Name of the auxiliary device to which the archive 

file belongs. 

3 35-0 Date and time from the archive file label in packed 

format. 



If the permanent file utility does not find the archive file label or if an error is detected in 
the archive file label, a 3-word block is written with all fields zero. 
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Catalog Image Record Entries Block (PFATC, PFDUMP, and PFLOAD utilities only). 
59 17 

Word 
1 
2 





Field 



Word Bits Description 



len 



CIR entry 



17-0 Length of this block excluding the control word (2 to 

1000 8 ). Block length = (number of CIR entries)*2. If 
more than 400 8 CIR entries exist, more than one 
CIR block will be written to the summary file. 

1-2 59-0 Catalog image record entry from the archive file. 

Refer to Catalog Image Record later in this section 
for the format of a CIR entry. 
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PFC Entries Block (all utilities) 

59 

Word 

1 

20 

21 



17 



CATE 


len 




PFC entry 1 




reserved 




I- 



PFC entry n 



reserved 



Field 



Word Bits Description 



len 







17-0 



PFC entry 



1-20 59-0 



21 



Length of this block excluding the control word (20 8 
to 1000 8 ). Block length = (number of PFC 
entries)*21 8 . 

PFC entries will be written to the summary file for 
all files selected for processing by the utility- If more 
than 37 8 files are selected for processing, more than 
one CATE block will be written to the summary file. 

PFC entry of the file processed by the permanent 
file utility. Refer to Permanent File Catalog Entry 
earlier in this section for the format of a PFC entry. 
For PFDUMP and PFATC, the first track pointer in 
the PFC entry indicates whether a file was disk 
resident before it was dumped. If PFDUMP staged 
the file to disk to dump data, the data is on the 
archive file, but the pointer is (zero). The PFC 
only flag in the CATE block shows whether the data 
was dumped. 

PFC only file flag (used only by PFDUMP and 
PFATC). This flag indicates that only the file's PFC 
entry and permits were written to the archive file. 
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Calling the Utilities 

Permanent file utility operations can be initiated through console input or DIS input to a 
K display, batch input, terminal input, or procedure files. However, for batch or terminal 
input, the user must be validated for system origin privileges and the system must be in 
debug mode. 

Console Input 

It is not possible to preassign an archive file when using the console input sequence. Since a 
preassigned archive file is usually required, this type of call to the utilities should be 
avoided in most cases (refer to DIS Input later in this section). However, the console input 
sequence can be used when an archive file is not required, as with the PFCAT utility. 

Input from the console requires the following sequence of entries and responses. 

1. Call PFS by entering: 

X.PFS. 

The B,0 display indicates the job sequence name (jsn) of PFS. To the right of the entry 
appears the message: 

REQUEST *K* DISPLAY 

2. Activate the K display for that control point by entering: 

K, jsn. 

jsn Description ^^ 



jsn Job sequence name of PFS as specified on the B,0 display. 

The display shown in figure 17-8 appears on the left screen. Instructions on the display 
describe how to select the desired utility. 

3. Select the desired utility by entering: 

K.uo. 

uo is one of the following: 



uo 


Description 


AT 


Catalog archive file. 


CA 


Catalog permanent files. 


CP 


Copy archived files to a job as local files. 


DU 


Dump permanent files. 


LD 


Load permanent files. 


RL 


Release disk space. 
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4. Activate the right K display by entering: 

KK. 

The display shown in figure 17-9 appears on the right and left screens. A description of 
the permanent file utility options is shown. 

The parameter options available under the chosen utility appear on the left screen. 
Figure 17-10 shows the left screen, the first of 5 pages, after the DU utility (PFDUMP) 
has been called. Figures 17-11 through 17-14 show the following pages. In figure 17-10, 
the TCE appearing after the LIST OPTIONS VALID (in the description column) 
indicates that 

T Files processed 

C Catalog image record (CD-I) files 

E Errors 

are the listings available for the PFDUMP utility. Different combinations of list options 
are available with the other utilities. 

The CAMTIDPSYZ appearing after the OPTIONS VALID (in the description column) 
indicates that the following options are available for the dump utility. Different 
combinations of utility options are available with the other utilities. 

Options Description 



C Creation. 

A Last access. 

M Last modification. 

T Last data modification. 

I Indirect access files. 

D Direct access files. 

P Purge after dump. 

S Suppress staging of files. 

Y Process all files as if backup is required. 

Z Clear alternate storage information in PFC entries. 
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K. PFS. 




jsn 


hh.imti. ss . 


yy/mm/dd. CDC NETWORK OPERATING SYSTEM 






MID=AA NOS version 






PERMANENT FILE UTILITY OPTIONS 




ENTER 


K.UO. 




UO 


DESCRIPTION 




AT 


PFATC (CATALOG TAPE) 




CA 


PFCAT (CATALOG PERMANENT FILES) 




CP 


PFCOPY (COPY TAPE) 




DU 


PFDUMP (DUMP PERMANENT FILES) 




LD 


PFLOAD (LOAD PERMANENT FILES) 




RL 


PFREL (RELEASE DISK SPACE) 



Figure 17-8. Initial Permanent File Utilities K Display (Left Screen) 



K. 


PFS . j sn 






OP OPTIONS 


LO OPTIONS 


A - 


LAST ACCESS. 


C - PERMANENT FILE 


C - 


CREATION. 


DEVICE CATALOG. 


D - 


DIRECT ACCESS. 


E - ERRORS. 


E - 


EXTRACT CATALOG IMAGE RECORD. 


S - SUMMARY. 


I - 


INDIRECT ACCESS. 


T - FILES PROCESSED. 


L - 


LOAD LEVELING. 




M - 


LAST MODIFICATION. 




- 


OMIT CATALOG IMAGE RECORD. 




P - 


PURGE AFTER DUMP. 




Q - 


ADD CATALOG AND PERMIT RECORDS. 




R - 


REPLACE. 




S - 


SUPPRESS FILE STAGING. 




T - 


DATA MODIFICATION. 




Y - 


PROCESS ALL FILES AS *BR=Y* . 




Z - 


ZERO OUT ASA LINKAGE. 




SPECIFY ONLY ONE OF (C, A, M, OR T) . 


OPTIONS ARE ENTERED AS - 


SPECIFY ONLY ONE OF (I OR D) . 


LO = CET. OR 






OP = CIP. 



Figure 17-9. Permanent File Utilities K Display (Right Screen) 
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5. Select the desired parameter options by entering: 

K. opt 1 =val 1 , opt 2 =val 2 , - - - , opt n =val n . 

The optpvalj are selected from the parameter option list on the left screen. The 
selected' parameters replace the default values listed on the left screen (refer to 
Description of Permanent File Utility Parameters later in this section). A period is 
required at the end of each entry. 

6. Initiate execution by entering: 

K.GO. 

The lower lines of the left display 

N/A MEANS PARAMETER DOES NOT APPLY TO THIS UTILITY. 

disappear and are replaced by: 

DEVICE MASK 
DATE TIME 

Values appear with these identifiers as processing continues. 
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K. PFS. jsn 

hh.nim.ss. yy/mm/dd. CDC NETWORK OPERATING SYSTEM 
MID=AA NOS version 



PFDUMP 

OPTION 

FM = FAMILY 

PN = 

DN = 1 

TD = 2 

UN = USER 

UI = 12 

DD = -- N/A - 

DI = -- N/A - 

LO = TCE 

L = OUTPUT 

OP = C 

EO PROCESS 



PAGE 1 OF 5 



DESCRIPTION 



FAMILY NAME (1-7 CHARACTERS) . 

PACK NAME (1-7 CHARACTERS) . 

DEVICE NUMBER (0-77B) . 

TRUE DEVICE NUMBER (0-77B) . 

USER NAME (1-7 CHARACTERS) . 

USER INDEX (0-377777B). 

DESTINATION DEVICE NUMBER (0-77B). 

DESTINATION USER INDEX (0-377777B). 

LIST OPTIONS VALID - TCE 

OUTPUT FILE NAME (1-7 CHARACTERS). 

OPTIONS VALID - CAMTIDPSYZ 

IF SPECIFIED, DO NOT PROCESS FILES WITH 

MASS STORAGE ERRORS. 



N/A MEANS PARAMETER DOES NOT APPLY TO THIS UTILITY. 



Figure 17-10. PFDUMP K Display (Left Screen) (Page 1 of 5) 



PFDUMP 


PAGE 2 OF 5 


OPTION 


DESCRIPTION 


SD NO SETTING 


IF SPECIFIED, SET DISK SPACE RELEASE DATE. 


UD -- N/A — 


IF SPECIFIED, UPDATE UTILITY CONTROL DATE. 


DT NO DESTAGE 


IF SPECIFIED, DESTAGE TO TAPE DUMP. 


IP NO INHIBIT 


IF SPECIFIED, INHIBIT PROCESSING. 


AD = 85/01/14. 


AFTER DATE (YYMMDD) . 


AT = 00.00.00. 


AFTER TIME (HHMMSS) . 


BD = 


BEFORE DATE (YYMMDD) . 


BT = 


BEFORE TIME (HHMMSS) . 


LS = 


LOWER FILE SIZE LIMIT. 


US = NO LIMIT 


UPPER FILE SIZE LIMIT. * = NO LIMIT. 


COS = 


CATALOG ONLY SIZE LIMIT. * = NO LIMIT. 


N/A MEANS PARAMETER 


DOES NOT APPLY TO THIS UTILITY. 



Figure 17-11. PFDUMP K Display (Left Screen) (Page 2 of 5) 
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PFDUMP 

OPTION 

T = TAPE 

SF = 1 

N = -- N/A -- 

VF = VERIFY 

MF = — N/A - 

RD = RELEASE 

S = 

SR = 860901 

LA = LVLO 

UA = LVL7 

PVSN TAPE2 
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ARCHIVE FILE NAME (1-7 CHARACTERS) . 
NUMBER OF FILES TO SKIP (0-99) . 
NUMBER OF FILES TO PROCESS (1-99). 
VERIFY FILE NAME (1-7 CHARACTERS) . 
MASTER FILE NAME (1-7 CHARACTERS) . 
RELEASE DATA FILE NAME (1-7 CHARACTERS) 
SUMMARY FILE NAME. 
SUMMARY FILE RECORD NAME. 
LOWER ACCESS LEVEL (1-7 CHARACTERS) . 
UPPER ACCESS LEVEL (1-7 CHARACTERS) . 
VSN OF PREVIOUS ARCHIVE TAPE (1-6 CHAR) . 



N/A MEANS PARAMETER DOES NOT APPLY TO THIS UTILITY. 



Figure 17-12. PFDUMP K Display (Left Screen) (Page 3 of 5) 



PFDUMP 
USER INDEX AND FILE NAME SELECTIONS 
ENTER * TO MOVE FORWARD, / TO MOVE BACKWARD 



PAGE 4 OF 5 



23- 


STUFF 


FILE9 


FILE23 


FILE37 


FILEA 


-500- 


FILE10 


FILE24 


FILE38 


FILE2 


ALL. 


FILE11 


FILE25 


-12345- 


FILE99 


-2000- 


FILE12 


FILE26 


ALL. 


24- 


FILE1 


FILE13 


FILE27 


-377777- 


A 


FILE2 


FILE14 


FILE28 


PROFILC 


AAA 


FILE3 


FILE15 


FILE29 


VALIDUS 


ABCD 


FILE4 


FILE16 


FILE30 




Z 


FILE5 


FILE17 


FILE31 




•300- 


FILE6 


FILE18 


FILE32 




ALL. 


FILE7 


FILE19 


FILE33 




-467- 


FILE8 


FILE20 


FILE34 




ALL. 


FILE8AB 


FILE21 


FILE35 




-470- 


FILE8GH 


FILE22 


FILE36 





Figure 17-13. PFDUMP K Display (Left Screen) (Page 4 of 5) 
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PFDUMP 




PAGE 5 OF 5 


MSE ALTERNATE STORAGE SELECTION 






RESIDENT 






TAPE ALTERNATE STORAGE SELECTIONS 


(21 


ALLOWED) 


NON-RESIDENT JQ1234 




ZA0000 


AA1000 PS6254 




ZZ9095 


AA6899 TB9005 




100000 


AB4095 UW2222 




541288 


AC5000 VX5432 






AC5001 VW7777 






AC5002 XX3131 







Figure 17-14. PFDUMP K Display (Left Screen) (Page 5 of 5) 

The entries shown in figure 17-13 of the display are in columns sorted by user index and 
within each user index the entries are sorted by file name. If all files for a user index are 
selected, ALL. is displayed. 

Figure 17-14 of the display shows alternate storage selections, if present. If the CA=K 
parameter is entered, RESIDENT is displayed as the MSE alternate storage selection. If 
the CA=N parameter is entered, NON-RESIDENT is displayed. VSNs entered with the 
TA=vsn parameter are displayed in columns sorted alphabetically. If the TA=N parameter 
is also entered, NON-RESIDENT is displayed before any VSNs. An entry of TA=R clears a 
NON-RESIDENT selection and any VSN selections and RESIDENT is displayed alone. 
When RESIDENT is selected, entry of VSNs is ignored since all VSNs are already implicitly 
selected. 



17-42 NOS Version 2 Analysis Handbook 60459300 U 



Calling the Utilities 



DIS Input 

The following DIS input sequence is recommended for calling PF utilities from the system 
console. Refer to section 4, DIS Operations. 

1. Call DIS by entering: 

X.DIS. 

2. If the utility requires an archive file, it must be preassigned before calling the utility. 
This can be done with a LABEL or ASSIGN command or by using an existing procedure 
file. 

3. Call the utility either by entering 

PFS. 

which leads to the same sequence of entries and responses previously described under 
Console Input, or by entering: 

PFuo , opt 1 =val 1 , opt 2 =val 2 , . . - , opt n =val n . 
Parameter Description 



uo One of the following utility options, 
uo Description 



ATC Catalog archive file. 

CAT Catalog permanent files. 

COPY Copy archived files to a job as local files. 

DUMP Dump permanent files. 

LOAD Load permanent files. 

REL Release disk space. 

optpvalj Desired parameter option and value for the selected utility (refer to 

Parameters for the Permanent File Utilities later in this section). 

If an error in parameters is detected at initiation of a utility, the utility aborts unless the 
OP=K option is specified. If OP=K is specified, control returns to PFS and you may then 
enter the correct parameters using the K display. 

Batch Input 

To call a utility from a batch job, you must be validated for system origin privileges and the 
system must be in debug mode. The following sequence of commands is used to call a utility. 

ujn. 

USER , username , password , f ami lyname . 

PFuo , opt 1 =val 1 , opt 2 =val 2 , . . . , opt n =val n . 

uo and opt^valj are the same as for DIS input. 
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Terminal Input 

The format of terminal input for calling the permanent file utilities is substantially the 
same as that for batch input. You must be validated for system origin privileges and the 
system must be in debug mode. You enter the batch subsystem (or use the X command), call 
the desired utility, and enter the appropriate parameters with the command: 

PFuo, opt 1 =val 1 , opt 2 =val 2 , . - . , opt n =val n . 

uo and optpval; are the same as for DIS input. 

Procedure Files 

Calling the PF utilities can be made simpler with site-defined procedure files. If these 
procedures are defined on file PEOCFIL under user name SYSTEMX (user index 377777 8 ), 
they can be called from DSD. Since user name SYSTEMX is valid only from system origin 
jobs, the file PROCFIL should be write-permitted to another user name; this will allow 
easier maintenance of site-defined procedures. 

For example, when called in the following manner, the procedure DUMPIT provides a full 
dump of device 1 of the system default family on archive tapes with VSNs of PFB11, PFB12, 
..., PFB16. 

X. BEGIN (DUMPIT, ,DBVICE=1, SET=B) 

The SET JOB command is used to set the UJN of the job so that the banner page indicates 
the dump operation performed. In this case it is FULL1B. 

. PROC , DUMPIT , DEVICE=0 , LISTOP=E , SET=A . 
SET JOB , UJN=FULL_DEVICE_SET . 

VSN, TAPE=PF_SET_DEVICE_1 / PF_SET_DEVICE_2 / PF_SET_DEVICE_3 / 

PF_SET_DEVICE_4 / PF_SET_DEVICE_5 / PF_SET_DEVICE_6 . 

LABEL , TAPE , D=GE , PO=W , W , FI = $FULL DUMP$ . 

PFDUMP , DN=DEVICE , LO=LI STOP . 



17-44 NOS Version 2 Analysis Handbook 60459300 U 



Parameters for the Permanent File Utilities 



Parameters for the Permanent File Utilities 

Table 17-1 lists the parameters accepted by each permanent file utility. An X means that 
the parameter is accepted; a blank means that the parameter is not accepted. Refer to 
descriptions of parameters following the table for more information. 

Table 17-1. Permanent File Utility Parameters 



Parameter PFATC PFCAT PFCOPY PFDUMP PFLOAD PFKEL 



AD 


X 


X 


X 


X 


X 


X 


AT 


X 


X 


X 


X 


X 


X 


BD 


X 


X 


X 


X 


X 


X 


BT 


X 


X 


X 


X 


X 


X 


CA 


X 


X 


X 


X 


X 


X 


CCA 


X 


X 


X 


X 


X 


X 


COS 








X 






CPF 


X 


X 


X 


X 


X 


X 


CTA 


X 


X 


X 


X 


X 


X 


CUI 


X 


X 


X 


X 


X 


X 


DD 










X 




DI 










X 




DN 




X 




X 


X 


X 


DT 








X 






EO 








X 


X 




FM 




X 




X 


X 


X 


I 


X 


X 


X 


X 


X 


X 


IP 








X 




X 


L 


X 


X 


X 


X 


X 


X 


LA 


X 


X 


X 


X 


X 


X 


LO 


X 


X 


X 


X 


X 


X 



(Continued on next page) 
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Table 17-1. Permanent File Utility Parameters 



Parameter 


PFATC 


PFCAT 


PFCOPY 


PFDUMP 


PFLOAD 


PFREL 


(Continued from previous 


page) 












LS 


X 




X 


X 


X 




X 


X 


MF 








X 










N 


X 






X 






X 




OP 1 


X 




X 


X 


X 




X 


X 


PF 


X 




X 


X 


X 




X 


X 


PN 






X 




X 




X 


X 


PVSN 










X 








RD 










X 








S 


X 




X 


X 


X 




X 


X 


SD 










X 








SF 


X 






X 


X 




X 




SR 


X 




X 


X 


X 




X 


X 


T 


X 






X 


X 




X 




TA 


X 




X 


X 


X 




X 


X 


TD 






X 




X 




X 


X 


UA 


X 




X 


X 


X 




X 


X 


UD 














X 




UI 


X 




X 


X 


X 




X 


X 


UN 


X 




X 


X 


X 




X 


X 


US 


X 




X 


X 


X 




X 


X 


VF 










X 








1. The options valid with the OP parameter depend upon 
explained in the OP=opt description. 


the utility being called, as 
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Description of Permanent File Utility Parameters 

Parameter Description 

AD=date Specifies the after date (AD) to be used when the OP=A, OP=C, OP=M, 

or OP=T option is selected. Specify the date using one of the following 
formats: 

date Description 

YYMMDD Explicit date entered as six decimal digits. YY = year, 
MM = month, DD = day. 

BDn Date n days before current date. Specify n with one to 

five digit decimal number. 

Bn Date n days before the current date. Specify n with a 

one to six digit decimal number. 

O Clears a previous AD entry. 

When AT=HHMMSS is specified or neither the BD (before date) or BT 
(before time) parameters are specified, the default after date is the 
current date. 

AT=time Specifies the after time (AT) or both the after date (AD) and after time 

(AT) to be used when the OP=A, OP=C, OP=M, or OP=T option is 
selected. If entered as an expression relative to the current date and 
time, both the after date and after time are determined and any 
previously specified AD=date entry is overridden. Specify the time 
and/or date using one of the following formats: 

time Description 

HHMMSS Explicit time entered as six decimal digits. HH = hour, 
MM = minutes, SS = seconds. 

BDn Time and date n days before the current time and date. 

Specify n with one to five digit decimal number. 

BHn Time and date n hours before the current time and date. 

Bn Time and date n hours before the current time and date. 

BMn Time and date n minutes before the current time and 

date. 
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Parameter Description 



AT=time (Continued) 



time Description 



BSn Time and date n seconds before the current time and 

date. 

O Clears a previous AT entry. 

The default is 000000 (midnight) when AD=date is specified and 
AT=time is not. 

BD=date Specifies the before date (BD) to be used when the OP=A, OP=C, 

OP=M, or OP=T option is selected. Specify the date using one of the 
following formats: 



date Description 



YYMMDD Explicit date entered as six decimal digits. YY = year, 
MM = month, DD = day. 

BDn Date n days before current date. Specify n with one to 

five digit decimal number. 

Bn Date n days before the current date. Specify n with a 

one to six digit decimal number. 

O Clears a previous BD entry. 

When BT=HHMMSS is specified, the default before date is the current 
date. 

BT=time Specifies the before time (BT) or both the before date (BD) and before 

time (BT) to be used when the OP=A, OP=C, OP=M, or OP=T option is 
selected. If entered as an expression relative to the current date and 
time, both the after date and after time are determined and any 
previously specified BD=date entry is overridden. Specify the time 
and/or date using one of the following formats: 

time Description 

HHMMSS Explicit time entered as six decimal digits. HH = hour, 
MM = minutes, SS = seconds. 

BDn Time and date n days before the current time and date. 

Specify n with one to five digit decimal number. 

BHn Time and date n hours before the current time and date. 
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Parameter 



BT=time 



CA=res 



Description 



(Continued) 
time 



Description 



Bn 
BMn 

BSn 





Time and date n hours before the current time and date. 

Time and date n minutes before the current time and 

date. 

Time and date n seconds before the current time and 

date. 

Clears a previous BT entry. 



The default before time is 000000 (midnight) when BD=date is 
specified and BT=time is not. 

The CA parameter selects files according to residence on cartridge 
alternate storage. 

Description 



res 

R 

N 



Select files that reside on cartridge alternate storage. 
Select files that do not reside on cartridge alternate storage. 



When generating a summary file for input to a destage dump file 
selection utility such as GENPFD, CA=N should be specified if files 
residing on cartridge alternate storage are to be excluded from 
consideration. 
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Parameter 



Description 



CCA=res 



The CCA parameter clears the effect of its corresponding CA 
parameter. This parameter is intended for K display use. 

res Description 

K Clear the selection of files that reside on cartridge alternate 

storage. 

N Clear the selection of files that do not reside on cartridge 

alternate storage. 



COS=size 
COS=* 



CPF=filename 



PFC only size threshold in sectors. Specifying COS=* sets an unlimited 
PFC only size threshold (forces a data dump of all files). 

This parameter determines whether PFDUMP will attempt to process 
a file as PFC only or force a dump of the file data. Processing files as 
PFC only reduces the time spent in dumping and loading operations 
and also reduces the size of the archive file. For files larger than or 
equal to the specified size, only the PFC entry and permits will be 
dumped if the file's backup requirement is met by a sufficient number 
of alternate storage copies. A file's backup requirement is met if the 
backup requirement is media dependent (BR=MD) and one alternate 
storage copy exists or if the backup requirement is yes (BR=Y) and 
more than one alternate storage copy exists. For all files smaller than 
the specified size, and for files larger than or equal to the specified size 
that are not backed up on alternate storage, the data will be dumped 
unless file staging is explicitly suppressed (OP=S) and the file is not 
disk resident. The COS parameter will not cause files with a backup 
requirement of none (BR=N) to be dumped. 

Specifying COS=* has the same effect as the OP=Y option for files with 
BR=MD except that OP=Y will not force a dump of the data of BR=Y 
files with multiple copies on alternate storage. Specifying COS=* is the 
only way to force a data dump of all files having multiple copies on 
alternate storage media. 

The COS parameter can be used on full and incremental dumps to 
dump the data of small disk resident files that are already backed up 
on alternate storage. This should reduce staging activity when 
permanent files are reloaded after a disk failure. 

This parameter clears the selection of the specified file. If that file was 
the only file selected for the user index, all files will be selected for the 
user index. To clear all file selections for the user index, use the CUI 
parameter. 
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Parameter 

CTA=res 



Description 



CUI=userindex 



DD=dn 



DI=userindex 



DN=dn 



The CTA parameter clears the effect of its corresponding TA 
parameter. This parameter is intended for K display use. 



res Description 



vsn Clear the selection of files that reside on the VSN specified by 

vsn. 
R Clear the selection of files that reside on all VSNs. 

N Clear the selection of files that do not reside on tape alternate 

storage. 

This parameter clears all file selections for the specified user index. 
This parameter is assumed octal unless the D radix or a nonoctal digit 
is specified. 

The 1- or 2-digit number that specifies the alternate device to which 
PFLOAD loads files when the device on which a file is to be loaded 
cannot be found, is not defined in the system, or cannot accept the file 
because of secondary mask restrictions. Default is (no device is the 
alternate). This parameter is assumed octal unless the D radix or a 
nonoctal digit is specified. 

The 1- to 6-digit number that specifies the destination user index to 
which PFLOAD loads all files being processed. Default is (that is, 
files are loaded to the user index from which they were dumped). This 
parameter is assumed octal unless the D radix or a nonoctal digit is 
specified. 

The 1- or 2-digit octal number that specifies the device within the 
famil y to be cataloged, dumped, or loaded. For PFLOAD, refer to 
PFLOAD Selection Process under Load Permanent File (PFLOAD) 
later in this section for more information. For PFCAT or PFDUMP, the 
following distinctions are made. If the specified device is a master 
device, all files cataloged on it (whether or not they reside on the device) 
are processed if they also meet all other specified selection criteria. 
However, files that reside on the device that are cataloged elsewhere 
are not processed. If the specified device is not a master device, all files 
residing on it are processed if they also meet all other specified 
selection criteria. (For nonmaster devices the DN and TD parameters 
have the same effect.) Default is for PFDUMP and PFLOAD (all 
devices are to be dumped or loaded). DN must be specified for PFCAT 
if an output file is selected (L and LO parameters). However, PFCAT 
does not require entry of the DN parameter if a summary file (S 
parameter) rather than an output file (L and LO parameters) is 
selected. In this case, all devices in the family will be processed. 
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Parameter 



Description 



DT 



EO 



FM=familyname 



I=filename 



IP 



L=filename 



LA=level 



LO=opt 



Destage the selected files to tape or optical disk alternate storage, 
depending on whether the file specified by the T parameter is assigned 
to a magnetic tape or to an optical disk file. This parameter cannot be 
specified on a dump of an auxiliary pack. Refer to section 12, Tape and 
Optical Disk Alternate Storage, for examples. 

Specifies that PFDUMP or PFLOAD does not process files with mass 
storage errors. If EO is not specified, PFDUMP dumps files, and 
PFLOAD loads files, regardless of mass storage errors. 

The 1- to 7-character name of the family of permanent file devices to be 
cataloged, dumped, or loaded. This parameter option is not required if 
only one family of devices is active in the system. Default is the default 
system family name. 

The 1- to 7-character name of the file from which input directives are 
to be read. Default is INPUT. Any valid permanent file utility 
parameter or K display option can be specified in the directives file, 
except for the I parameter itself. The directives file is typically used to 
specify multiple user indices and file names for processing. 

Inhibit processing. This parameter specifies that PFDUMP or PFREL 
will generate an output file and/or summary file (as determined by the 
L, LO, and S parameters) listing the files that would have been 
processed by that utility without actually dumping files or releasing 
disk space. A selection utility (such as GENPFD) can use the summary 
file to generate a directives file specifying file names to be processed by 
PFDUMP or PFREL without processing inhibited. Default is that 
processing is not inhibited. 

The 1- to 7-character name of the file on which reports are to be 
written. Default is OUTPUT. 

The 1- to 7-character name that specifies the lower limit of the range of 
access levels to process. If this parameter is specified, the UA 
parameter must also be specified. If neither LA nor UA is specified, the 
default is that all access levels are selected. Refer to PFDUMP in a 
Secured System later in this section. 

Characters) specifying the type of information that the permanent file 
utility should include in its output report. Default is (no options 
selected). 

opt Description 

C List all files in the catalog image record. This option is used 

only with PFATC, PFDUMP, and PFLOAD. 

E List errors. 

S List cumulative statistics. This option is used only with 

PFCAT. 

T List PFC data for all files processed. 
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Parameter 



LS=size 



MF=filename 



N=n 



OP=opt 



Description 



Lower size limit in sectors. When specified, only files of size greater 
than or equal to the lower size limit will be processed. For PFDUMP, 
the file size limit is checked before the COS parameter (if COS is 
specified). 

The 1- to 7-character name of the master file to which PFCOPY copies 
all the files extracted from a designated archive file. Default is no 
name; that is, the archived files are copied as individual files retaining 
their permanent file names. 

This option allows you to extract a file from an archive file and change 
its name as a local file. 

The 1- or 2-digit number that specifies the number of archive files on a 
multifile archive file to be processed. If n=0, one file is processed. 
Default is 1. This parameter is assumed decimal unless the B radix is 
specified. 

The 1- to 7-character string specifying the utility options that control 
the processing of files. Many of the options require additional 
parameters to complete the definition of the OP selection. Default is 
(no options selected). 

opt Description 



K Specifies that the K display should be brought up if an error is 

detected when processing input parameters and directives in 
PFS. If OP=K is not specified, the permanent file utility will 
abort if such an error is detected (which allows exit processing 
to be programmed within the calling procedure). 

Only one of options A, C, M, or T can be used at a time. Each of these 
options requires one of the following to be specified. 

• Specify BD/BT to select all files having a last access date/time (if 
OP=A), a creation date/time (if OP=C), a utility control date/time 
(if OP=M), or a data modification date/time (if OP=T) prior to this 
date/time. 

• Specify AD/AT to select all files having a last access date/time (if 
OP=A), a creation date/time (if OP=C), a utility control date/time 
(if OP=M), or a data modification date/time (if OP=T) more recent 
than this date/time. 

• Specify both BD/BT and AD/AT to select all files having a last 
access date/time (if OP=A), a creation date/time (if OP=C), a utility 
control date/time (if OP=M), or a data modification date/time (if 
OP=T) in the interval defined by these dates/times. The date/time 
specified by BD/BT must be more recent than the date/time 
specified by AD/AT to properly define an interval. 
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Parameter Description 



OP=opt (Continued) 

See the descriptions of the AD, AT, BD, and BT parameters for more 
information. 



opt Description 

A Make selection according to time of last access. 

C Make selection according to time of creation. 

M Make selection according to time of last modification. 

T Make selection according to time of last data modification. 

The following rules apply when OP=M is used. If the utility control 
date and time field meets the specified date/time criteria, the file is 
selected. If the date/time criteria are not met, the file can still be 
selected if the control modification date and time field meets the 
date/time criteria and is more recent than the utility control date and 
time field. Refer to Permanent File Catalog Entry earlier in this 
section for descriptions of the PFC fields. 

The T option is intended to allow recently modified files to be excluded 
when creating a summary file for input to a destage file selection 
utility such as GENPFD. 

Only one of the following two options can be used at a time. They can 
be used in conjunction with the A, C, M, or T option. 

opt Description 

D Select direct access files only. 

I Select indirect access files only. 
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Parameter Description 



OP=opt (Continued) 

The following options are used only with PFDUMP. The P and S 
options cannot be specified at the same time. 



opt Description 



P 7 Purge after dump. PFDUMP keeps a list of all the files it 

actually dumps on a scratch file. After the dump is complete 

and successful, PFDUMP then does a PURGE on each file that 

it actually dumped. If PFDUMP aborts or the operator drops 

PFDUMP before all of the files are dumped, none of the files 

are purged. Since the catalog track interlock is released 

between the dump and the purge, it is ossible that a user could 

update a file during this interval; if this happens, the file is 

still purged. 

If this option is specified, backup requirement parameters are 

ignored when selecting files to process. Files with no backup 

requirement (BR=N) are processed, and the data for files 

residing on alternate storage media are dumped, regardless of 

file backup requirements. 

Files whose user indexes are greater than or equal to PGUI 
(default value is 300000 8 ) are not dumped or purged unless 
specific user indices are selected with the UI parameter. This 
is done to prevent files such as critical recovery files, 
applications, and system utilities from being purged from the 
system due to lack of use. If the UI parameter is used to select 
files cataloged on user indices greater than or equal to the 
PGUI threshold, the files are dumped and purged. 

S 8 Suppress staging of files. If a file to be dumped resides on 

MSE, optical disk, or tape alternate storage and not on disk, it 
is not staged to disk and only its PFC and permit entries are 
copied to the archive file. If OP=S is omitted, the alternate 
storage file is copied to disk and included in the dump. This 
option should normally be specified for full dumps. 

Y 7 This option causes all files to be processed the same as files 

with backup requirement BR=Y. 

Z Clear the cartridge and tape alternate storage information in 

the PFC entries written to the dump file. 



7. Refer to Permanent File Catalog Entry earlier in this section for a description of the backup 
requirement field. 

8. Refer to section 11, MSE, or to section 12, Tape and Optical Disk Alternate Storage, for more 
information. 
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Parameter Description 



OP=opt (Continued) 

The following six options are used only with PFLOAD. 



opt Description 

R Load with the replace option. If R is specified, PFLOAD loads 

all selected files from the archive file even if files with the 
same name already exist in the permanent file system. If R is 
not specified, PFLOAD loads only those files selected from the 
archive file for which no corresponding files (files with 
identical file names and user indexes) already exist in the 
permanent file system. 

E Extract only the CIR. Refer to the PFLOAD description for 

information about the CIR. PFLOAD reads the CIR from the 
archive file, generates a random file and directory, and 
requests the next archive file without processing any of the 
files after the CIR on the first archive file. 

L Load each direct access file on the device with the most 

available space of those devices where the file is eligible to 
reside. This option overrides the DD parameter if it is also 
specified. 

O Do not read the CIR. PFLOAD does not read the CIR for the 

specified archive file but processes the records in this archive 
file. PFLOAD then terminates normally without requesting 
another archive file. 

V Request the next archive file by using the volume serial 

number (VSN) found in the PVSN field of the archive file. 
PFLOAD will automatically request a tape with this VSN 
when finished with the current archive file. Refer to the PVSN 
parameter description for more information. 

Z 9 Clear the alternate storage information in the PFC entry when 

the PFC entry is loaded, if the information points to an MSE, 
optical disk, or tape alternate storage image. Also suppresses 
the loading of PFC only files. Default is to leave the alternate 
storage information intact and to load PFC only files. OP=Z 
should normally be omitted if the device has to be recovered 
and should be specified if data for the file is being reloaded. 



9. Refer to section 11, MSE, or to section 12, Tape and Optical Disk Alternate Storage, for more 
information. 
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Parameter 



Description 



OP=opt 



(Continued) 

The following option is used only with PFCOPY. 

opt Description 

Q Select leading records. The archived file that is copied to the 

job as a local file includes two header records, one with the 
catalog entry for the file and the second with the permit 
information for the file. 



PF=filename 



PN=packname 



PVSN=vsn 



RD=filename 10 



The 1- to 7-character name of a permanent file to be processed. The 
selected file names appear on page 4 of the left K-display screen (refer 
to figure 17-13). To delete a permanent file name that has been entered, 
use the CPF parameter. When used from one of the utility commands, 
up to 10 file names can be entered on one line. The following parameter 
format is used for both the K-display and the utility commands. 

PF=f ilenamel , PF=f ilename2 , . . . , PF=f ilenamen 

Use of the PF parameter without a preceding UI or UN parameter is an 
error. Default is that permanent file names are not selection criteria. 

The 1- to 7-character name of the auxiliary device to be cataloged, 
dumped, or loaded. The device must be mounted and available. Default 
is that pack name is not a selection criterion. 

The 1- to 6-character tape VSN to write into the PVSN field of the 
archive file. This value, stored in the PFDUMP label of the archive file, 
is usually the first tape VSN of your previous archive file. You can use 
this parameter to automate reloading of a device. Typically, you use 
PFLOAD to process the most recent set of archive file tapes, mount the 
next most recent set, and so on, completing the reload with your most 
recent set of full dump archive file tapes. Requesting of these sets may 
be automated by having each incremental set point to its previous set; 
that is, equating the PVSN value to the tape VSN on the first reel of 
the previous set. If you subsequently perform a PFLOAD, specifying 
OP=V will cause PFLOAD, upon completion of one set of archive file 
tapes, to automatically request the next set, using the PVSN value 
read from the PFDUMP label. 

The 1- to 7-character name of the release data file (RDF) to be created 
by PFDUMP, which identifies those MSE-resident files that are pointed 
to by PFC entries at the time of the dump. The MSE utility SSVAL 
uses this file to identify unneeded MSE-resident files whose space can 
be released. If RD alone is specified, the release data file created is 
named ZZZZRDF. Default is that PFDUMP does not create an RDF. 



10. Refer to section 11. MSE, for more information. 
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Parameter 



Description 



SD" 



S=filename The 1- to 7-character name of a summary file generated by the 

permanent file utilities. Default is SUMMARY. The summary file 
contains the PFC entries for those files processed by the utility. Refer 
to Summary File earlier in this section for additional information and 
the format of the summary file. For the PFCAT utility, a summary file 
and an output file (L and LO parameters) cannot be specified 
simultaneously. 

Specifies that PFDUMP is to enter the date and time when the dump 
was initiated into the inhibit date/time field of the master device. This 
date/time entry is used by PFDUMP, PFREL, and by the MSE utility 
SSMOVE to determine whether the disk image of a file can be released. 
If a file was last modified before this date/time, this PFDUMP is 
considered a backup copy for the purpose of satisfying the 
user-specified backup requirement (BR) for that file. Refer to PFDUMP 
in an MSE, Tape, or Optical Disk Alternate Storage Environment later 
in this section for more information. 

The 1- or 2-digit number that specifies the number of archive files on a 
multifile archive file to be skipped before processing begins. Default is 
0. This parameter is assumed decimal unless the B radix is specified. 

The 1- to 7-character name of the summary file record generated by the 
permanent file utilities. Default is the current date in the form 
yymmdd. The specified record name will be written to the prefix table 
of the record generated. Refer to Summary File earlier in this section 
for the format of the prefix table. 

T=filename The 1- to 7-character name of the file on which to store or read archive 

files. Usually, filename is a tape, but it can be a mass storage device. 
Default is TAPE. 

TA=res The TA parameter selects files according to residence on the specified 

tape alternate storage VSN. 

res Description 

vsn 



SF-n 



SR-recordname 



Select tape alternate storage resident files that reside on the 
VSN specified by vsn. 

R Select tape alternate storage resident files that reside on all 

VSNs. 
N Select files that do not reside on tape alternate storage. 



When selecting files to be destaged to tape alternate storage, TA=N 
should be specified to prevent selection of files already destaged to 
other tapes. 



11. Refer to section 11. MSE, for more information. 
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Parameter 



Description 



TD=dn 



UA=level 



UD 12 



m=userindex 



UN=username 



The 1- or 2-digit octal number that specifies the device within the 
family to be dumped or loaded. This is the device number specified by 
the EQPDECK PF entry for the device. You can determine which device 
number to use within the family by referring to the DSD Family Status 
Display (E,F) described in the NOS Version 2 Operations Handbook. 

For PFLOAD refer to PFLOAD Selection Process under Load 
Permanent File (PFLOAD) later in this section for more information. 
For PFDUMP, the following distinctions are made. If the specified 
device is a master device, all files cataloged and/or residing on it are 
processed if they meet all other specified selection criteria. If the 
specified device is not a master device, all files residing on it are 
processed if they also meet all other specified selection criteria. (For 
nonmaster devices the DN and TD parameters have the same effect.) 
Default is (all devices are to be dumped or loaded). 

The 1- to 7-character name that specifies the upper limit of the range 
of access levels to process. If this parameter is specified, the LA 
parameter must also be specified. If neither LA nor UA is specified, the 
default is that all access levels are selected. Refer to PFDUMP in a 
Secured System later in this section. 

Specifies that PFLOAD is to update the utility control date and time 
field in the PFC entry for the file being loaded. This ensures that the 
file will be considered for inclusion in the next incremental dump. UD 
should normally be specified when a particular user's files are being 
reloaded, but should normally be omitted when a full device is being 
reloaded. 

The 1- to 6-digit number that specifies the user index under which files 
to be processed are located. If UI is specified, DN need not be specified 
because the utility will locate the proper device. Default is that user 
index is not a selection criterion. This parameter is assumed octal 
unless the D radix or a nonoctal digit is specified. 

If no file selections are in effect for the affected user index at the time 
of entry, the UI parameter selects all files for the user index and also 
specifies the user index to be assumed for subsequent PF directives. If 
file selections are already in effect for the user index, the UI parameter 
simply sets the assumed user index for subsequent PF directives. 

The 1- to 7-character user name associated with the PN parameter. 
The user name must match information in the MST for the specified 
pack name. If UN is specified and PN is not, the utility will convert 
username to a user index. If, in addition, DN is not specified, the 
utility will locate the proper device in the family. Default is that user 
name is not a selection criterion. 



12. Refer to section 11, MSE, for more information. 
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Parameter 



Description 



UN=username 



US=size 



VF=filename 



(Continued) 

If no file selections are in effect for the affected user index at the time 
of entry, the UN parameter selects all files for the user index and also 
specifies the user index to be assumed for subsequent PF directives. If 
file selections are in effect for the user index, the UN parameter simply 
sets the assumed user index for subsequent PF directives. 

Upper size limit in sectors. When specified, only files of size less than 
or equal to the upper size limit will be processed. For PFDUMP, the 
file size limit is checked before the COS parameter (if COS is specified). 

The 1- to 7-character name that specifies that PFDUMP is to produce a 
verify file which is a duplicate of the archive file it creates. If VF alone 
is specified, the verify file is named PFVER. Default is that no verify 
file is written. 

Example: 

The following series of commands creates a two-file archive file (AA) 
and a matching verify file (BB). The VERIFY command compares the 
accuracy of the duplication. (Refer to the NOS Version 2 Reference Set, 
Volume 3 for a complete description of VERIFY.) 



Command 



Description 



PFDUMP,T=AA,VF=BB. 



PFDUMP,T=AA,VF=BB. 



VERIFY,AA,BB,N=OAR- 



The dump is written on archive file AA. 
A duplicate is written on the verify file 
BB. PFDUMP does not rewind after 
processing. 

A second dump is written after the first 
on both the archive (AA) and the verify 
(BB) files. Each dump produces a 
separate file on the archive and verify 
files. 

A binary comparison of AA and BB is 
performed. If words do not match, this 
command lists: 

Record number 

Word number within the record 

Words from both files that do not 
match 

N=0 specifies that the verify terminates 
when the first empty file is encountered. 
The A parameter specifies an abort if a 
mismatch is found. R rewinds both files 
before and after the verify. 
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Preassigning the Archive File 

In all permanent file utilities except PFCAT and PFREL, the archive file must be 
preassigned. This can be done by using the LABEL or ASSIGN command. For example, file 
assignment can be made with the following commands. 

LABEL, TAPE, VSN=PFDUMP, NT, D=1600 . 

or 

ASSIGN, NT, TAPE. 

If no archive file is present, PFDUMP will write on a local mass storage file. The other 
utilities will attempt to read an empty archive file and terminate. PFLOAD will 
automatically request the assignment of any incremental or full dump archive tapes needed 
after the first tape; the request will be for the same track type and density as the first 
archive tape. 

Further automation may be added by indicating all tape VSNs during PFDUMP and/or 
PFLOAD, which automates the archive tape VSN requests within one archive file. This may 
be done through the VSN command (refer to Procedure Files earlier in this section). You 
can also use the PFDUMP parameter PVSN and PFLOAD option OP=V, which automates 
the archive tape VSN requests between archive files. Refer to the PVSN parameter 
description for more information. 



NOTE 



The archive file is not rewound or unloaded before or after processing by any of the utilities, 
except before a PFLOAD tape request. 
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Permanent File Utility Routines 

The parameters available for each of the permanent file utility routines, discussed next, are 
listed in table 17-1. 

The LO parameter allows each permanent file utility to produce a cataloged directory of file 
information. This catalog information is either derived from the catalog tracks on the 
permanent file device or from the archive tape. Although the header information may differ 
from utility to utility, the format of the catalog information remains the same. Following is 
the general format of the information listed for each file on the directory. 

filename type cat length dn cdate ladate dmdate caudate ucdate 

password count userindex mode subsystem time time time time time 

exp date level pr br ac rs cflags cat asa amsg 

charge project tflags tape vsn segn 

Figure 17-15 illustrates a typical page from a cataloged directory. Although this directory 
was produced using the command PFATC,LO=T., directories in similar format could be 
produced using the other utilities. Each of the following fields is shown and cross-referenced 
on the figure. 



Header Information 13 Description 



1 
2 



4 
5 



10 



filename 

type 

cat 

length 
dn 



6 


password 


7 


count 


8 


userindex 


9 


mode 



subsystem 



Permanent file name. 

Type of permanent file. This field can be either direct access 
(DIR) or indirect access (IND). 

File category. This field can be either PRIVATE, SPRIV, or 
PUBLIC. These categories are described in the NOS Version 
2 Reference Set, Volume 3. 

Length of the file in decimal PRUs. 

For direct access files, the device number of the mass storage 
device on which the file resides if other than the master 
device. If the file resides on the master device, this field is 
replaced by an *. 

Password associated with the file. 

Count that specifies the number of times the file has been 

accessed. 

User index of the user on whose catalog this file resides. 

Permission mode. This field can be WRITE, MODIFY, 
UPDATE, APPEND, READ, READMD, READUP, READAP, 
EXECUTE, or NULL. These modes are explained in detail in 
the NOS Version 2 Reference Set, Volume 3. 

Subsystem under which the file was saved. Possible entries 
include FORT., FTNTS, BASIC, EXEC, or BATCH. If this 
field contains no entry, a subsystem is not associated with the 
file. 



13. Numbers in figure 17-15 are circled. 
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Header Information 14 Description 



11 



19 



cdate time 



12 


ladate time 


13 


dmdate time 


14 


cmdate time 


15 


ucdate time 


16 


exp date 


17 


level 


18 


pr 



br 



Date and time of file creation. The format is: 

yy/mm/dd. 
hh.mm.ss. 

Date and time of the last access to the file. 

Date and time of the last data modification to the file. 

Date and time of the last control information modification in 
the file's PFC entry or permit entries. 

Utility control date and time set by PFM or a PF utility to 
ensure that the file will be included in the next incremental 
(OP=M) dump. 

Expiration date associated with the file password. 

Security access level assigned to the file. 

Preferred residence for the file. This field can be: 



Field Description 



L Locked to disk. 

D Disk residence preferred. 

M Cartridge alternate storage (MSE or optical disk) 

residence preferred. 

N No preference. 

T Tape alternate storage residence preferred. 



Backup requirement for the file. This field can be: 

Field Description 

Y Two backup copies required. 

MD One backup copy required. 

N No backup copy required. 



Refer to PFDUMP in an MSE, Tape, or Optical Disk 
Alternate Storage Environment later in this section for more 
information. 



14. Numbers in figure 17-15 are circled. 
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Header Information 15 Description 



20 



21 



ac 



rs 



22 



cflags 



Alternate user CATLIST permission for the file specified by 
the file owner. This field can be Y (alternate user can obtain 
CATLIST information about the file) or N (alternate user 
cannot obtain CATLIST information about the file). 

Current residence for the file. Possible values are D, DC, DT, 
DCT, CT, C, and T. If a D is present, the file currently has a 
copy on disk. If a C is present, the file currently has a copy on 
cartridge alternate storage (MSE or optical disk). If a T is 
present, the file currently has a copy on tape alternate 
storage. 

Cartridge alternate storage flags set for the file (refer to 
Permanent File Catalog Entry earlier in this section for 
details). If a flag is not set, a dash is listed. If an undefined 
flag is set, an asterisk is displayed. This field can be: 

Field Description 

D 
F 
L 

R 
S 
T 
V 



Data error flag. 
Free up cartridge flag. 
Locked to disk flag. 
Obsolete flag. 
Pseudorelease flag. 
System control error flag. 
Temporary error flag. 
Verification flag. 



23 



cat 



24 


asa 


25 


amsg 


26 


charge 


27 


project 



Cartridge alternate storage type. This field can be NONE (no 
cartridge alternate storage), MSE (file resides on MSE), or 
OD (file resides on optical disk). 

Cartridge alternate storage address of the file. 

Appended message, *PFC ONLY, indicating when a PFC 
ONLY file (that is, an entry with PFC and permit entries, but 
no data) has been processed on the archive file. 

Charge number associated with the file. 

Project number associated with the file. 



15. Numbers in figure 17-15 are circled. 
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Header Information 16 Description 



28 



tflags 



Tape alternate storage flags set for the file (refer to 
Permanent File Catalog Entry earlier in this section for 
details). If a flag is not set, a dash is listed. If an undefined 
flag is set, an asterisk is displayed. This field can be: 



Field Description 



A File on ACS tape. 

C File on either ACS or CTS tape. 

D Data error on primary VSN flag. 

E Data error on secondary VSN flag. 

F Tape recorded in LI format. 

L Destage in progress flag. 

N Secondary VSN not available flag. 

P Primary VSN not available flag. 

S Secondary VSN exists flag. 

V Verification flag. 



29 
30 



tape vsn 
seqn 



VSN of the tape containing the tape alternate storage copy of 
the file. 

Sequence number on the tape containing the tape alternate 
storage copy of the file. 



16. Numbers in figure 17-15 are circled. 
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PFATC. FILES ON ARCHIVE FILE. 

ARCHIVE FILE CREATE* yy/m/dd. 

FILE NAME FILE TYPE LENGTH DM 

PASSWORD COUNT INDEX PERM. SUBSYS 
EXPIRES LEVEL PR 8ft AC RS 
CHARGE NO. PROJECT NUMBER 

(3D _j» ® 

1 lARCPPDt fPIRjlPUBLICl J26] 

3320 READ 
LVLO N Y N DT 



hh. 



FAMILY * SYS964. 
.ss. ARCHIVE FAMILY 



TEST. 



lasf 



2 SITRPT IND. PU BLIC© <§) 12 

@m fisaa IreaSi 

LVLO N V *l DT 



MmmES 



3 LISTEXB IND. PUBLIC & 

3320 READ lBATfW 
LVLO N Y N DT <ftjj 



4 FSEPZ19 IHD. PRIVATE 
3320 



5 DECK3 



CREATION ACCESS DATA MOD CONTROL UTILITY 
DATE/TIME DATE/TINE DATE/TIME DATE/TIME DATE/TIME 
CARTRIDGE FLAGS TYPE CARTRIDGE ASA 

TAPE FLAGS TAPE VSN SEQ. NUMBER 

87/04/13. 87/04/13. 87/04/13. 87/04/13. 87/04/13. 
15.22.31. 15.22.31. 15.22.31. 15.22.31. 15.22.31. 
HOME 

.- V AA1234 

87/04/13. 87/04/13. 87/04/13. 87/04/13. 87/04/13. 
15.22.29. 15.22.29. 15.22.29. 15.22.29. 15.22.29. 

NONE 

_— v AA1234 1 

87/04/13. 87/04/13. 87/04/13. 87/04/13. 87/04/13. 
15.22-29. 15.22.29. 15.22.29. 1S.22.29. 15.22.29. 

NONE 

V _ AMZ5* ?-, 

& 62) 63> (fi> & 



READ 



87/04/13 
1S.22.29 



67/04/13. 
15.22.29, 



87/04/13 
15.22.29 



87/04/13 
15.22.29. 



87/04/13.1 
15.22. 



IND. PUBLIC 

3320 READ 
LVLO N Y N DT 



6 SHORT IND. PUBLIC 11 

3320 READ 

.L VLO N Y N DT 

@EH9 ea i1ZRB5*56l 

7 PFHELPR IND. PUBLIC 6 

3320 READ 
LVLO N Y N DT 



8 PFACC IND. PUBLIC 36 

3320 READ 
LVLO N Y N »T 



87/04/13. 
15.22.29, 



87/04/13, 
15.22.29, 



NONE 

V AA1234 

87/04/13. 87/04/13. 
15.22. 29^ 15.22 .29. 

\ &mm @ 

V AA1234 



J7t33 

;.29.l 



87/04/13. 
15.22.29. 



87/04/13, 
15.22.29, 



87/04/13. 
15.22.29. 



87/04/13, 
15.22.29. 



87/04/13, 
15.22.29, 



87/04/13. 87/04/13. 

15.22.29. 15.22.29. 

NONE 

VI <a iAAl234l 



87/04/13. 87/04/13. 87/04/13. 

15.22.29. 15.22.29. 15.22.29. 

NONE 

V AA1234 

87/04/13. 87/04/13. 87/04/13. 

15.22.29. 15.22.29. 15.22.29. 

NONE 

V AA1234 



87/04/13. 
1S.22.29. 

87/04/13. 
15.22.29. 



87/04/13. 
15.22.29. 



Figure 17-15. Sample Directory Produced by PFATC,LO=T. 
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Catalog Archive File (PFATC) 

PFATC produces a cataloged directory of file information derived from an archive file 
previously created by the PFDUMP utility. The format of the directory depends upon the 
parameters selected. 

If LO=T (list all files processed) is specified, the directory produced is similar to that shown 
in figure 17-15. If LO=C (list all files in catalog image record) is specified and the archive 
file to be cataloged was produced by an incremental dump (refer to Incremental Permanent 
File System Dump later in this section), the directory produced is similar to that shown in 
figure 17-20. 

Catalog Permanent File Device (PFCAT) 

PFCAT produces a cataloged directory of file information derived from catalog tracks on a 
master device. The format of the directory depends upon the parameter options selected. 

If LO=T (list all files processed) is specified, a directory of file information and a mass 
storage table report are produced. The directory is similar to that shown in figure 17-16. 
However, the files are fisted according to user index, and totals are given after the files for 
each user index. The mass storage table report gives information about each mass storage 
device in the system. Figure 17-17 is an example of a mass storage table report. Messages 
issued with this report give information concerning the type and status of the device 
cataloged. The following status messages can be issued. 

ACCOUNT INITIALIZE PENDING. 
CATALOG TRACK OVERFLOW. 
DAYFILE INITIALIZE PENDING. 
ERRLOG INITIALIZE PENDING. 
FORMAT PENDING. 
I/O QUEUE INITIALIZE PENDING. 
MAINLOG INITIALIZE PENDING. 
PF INITIALIZE PENDING. 
TOTAL INITIALIZE PENDING. 
UNAVAILABLE FOR PF ACCESS. 
8 WORD CATALOG ENTRIES. 

The following types of devices can be listed. 

ALTERNATE SYSTEM 
REMOVABLE DEVICE 
SYSTEM 

If LO=S (list cumulative statistics for catalog) is specified, summary reports of file 
information for each user index and for the entire device are produced. Figure 17-18 lists a 
page of the information given for each user index. Figure 17-19 lists the general device 
information. 

If TA=vsn (select tape alternate storage resident files that reside on vsn) is specified, 
PFCAT lists all current files that reside on a particular tape VSN. This can be used to 
determine if a specific tape may be recycled. Refer to section 12, Tape and Optical Disk 
Alternate Storage, for more information about recycling dump tapes. 
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CATALOG FILE yy/mm/dd. hh.mm.ss. 

DIRECTORY OF PERMANENT FILE DEVICE 40 SYS964 PAGE 1 

CATALOG OF USER INDEX 1 

FILE NAME FILE TYPE LENGTH DN CREATION ACCESS DATA MOD CONTROL UTILITY 

PASSWORD COUNT INDEX PERM. SUBSYS DATE/TIME DATE/TIME DATE/TIME DATE/TIME DATE/TIME 
EXPIRES LEVEL PR BR AC RS CARTRIDGE FLAGS TYPE CARTRIDGE ASA 

CHARGE NO. PROJECT NUMBER TAPE FLAGS TAPE VSN SEQ. NUMBER 

1 TSTESTA IND. PRIVATE 4 B2/09/19. 86/04/17. 82/09/19. 87/05/11. 82/09/19. 

150 WRITE FTKTS 19.35.51. 10.45.07. 19.35.51. 13.43.30. 19.35.51. 

LVL0 N Y N D NONE 

2 TESTB IND. PRIVATE 5 82/09/19. 86/04/17. 82/09/19. 87/05/11. 82/09/19. 

150 WRITE 19.35.51. 10.45.07. 19.35.51. 13.43.30. 19.35.51. 

LVL0 N Y N D NONE 

3 TESTA IND. PRIVATE 3 82/09/19. 86/04/17. 82/09/19. 87/05/11. 82/09/19. 

150 WRITE FORT. 19.35.51. 10.45.07. 19.35.51. 13.43.30. 19.35.51. 

LVL0 N Y N D NONE 

4 PROCB IND. PRIVATE 1 75/09/16. 86/04/17. 75/09/16. 87/05/11. 75/09/16. 

193 WRITE 01.16.10. 10.45.07. 01.16.10. 13.43.30. 01.16.10. 

LVL0 N Y N D NONE 

5 PROCC IND. PRIVATE 1 75/09/16. 86/04/17. 76/05/06. 87/05/11. 76/05/06. 

195 WRITE 01.16.11. 10.45.07. 12.13.40. 13.43.30. 12.13.40. 

LVL0 N Y N D NONE 

6 TESTC IND. PRIVATE 1 75/04/22. 86/04/17. 76/06/02. 87/05/11. 76/06/02. 

202 WRITE 23.40.27. 10.45.07. 19.25.46. 13.43.30. 19.25.46. 

LVL0 N Y N D NONE 

7 IDA IND. PRIVATE 6 75/09/17. 86/04/17. 76/06/02. 87/05/11. 76/06/02. 

191 WRITE 01.43.02. 10.45.07. 19.25.59. 13.43.30. 19.25.59. 

LVL0 N Y N D NONE 

8 TESTRJ IND. PRIVATE 15 75/09/17. 86/04/17. 76/06/02. 87/05/11. 76/06/02. 

188 WRITE 01.43.03. 10.45.07. 19.26.04. 13.43.30. 19.26.04. 

LVL0 N Y N D NONE 

Figure 17-16. Sample Directory Produced by PFCATJLO=TJDN=40,UI=4054 

MASS STORAGE TABLE REPORT yy/mm/dd. hh.mm.ss. 

FAMILY/ PACK NAME SYST64 

DEVICE NUMBER = 1 DEVICE TYPE = DJ 

DEVICE MASK = 377 NUMBER UNITS = 1 

SECONDARY MASK = 377 USER NAME = 

D/A USER COUNT = EQUIPMENT STATUS = ACTIVE 

SYSTEM. 

Figure 17-17. Mass Storage Table Report 
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SUMMARY REPORT yy/mm/dd. hh.mm.ss. 

DIRECTORY OF PERMANENT FILE DEVICE 40 SYS964 PAGE 1 

( * = DAF RESIDENT ON OTHER THAN MASTER DEVICE . ) 
USER INDEX FILES SECTORS AVE. SEC. 



1000 


4 


21 


5 


3000 


30 


1163 


38 


6000 


44 


602 


13 


60000 


1 


5 


5 


2020 


1 








4420 


2 


2 


1 


60 


7 


75 


10 


530 


21 


443 


21 


160 


2 


240 


120 


2160 


14 


25 


1 


260 


37 


5024 


135 


270 


70 


6352 


90 


2750 


251 


1386 


5 


377760 


1 


68 


68 


2370 


22 


626 


28 


377770 


1 


53 


53 



1 

21 

31 

51 

3511 

201 

22201 

3641 

301 

311 

3331 

43331 

2741 



508 

34 

96 

15 

5 

1 

7 

3 

40 

27 

1 

8 

36 

15 

288 



16085 (GROUP TOTAL) 



153 


4 


1256 


13 


87 


5 


5 


1 


21 


21 


77 


11 


362 


120 


1788 


44 


1020 


37 


3 


3 


168 


21 


296 


8 


1399 


93 


6635 


(GROUP TOTAL) 



Figure 17-18. Cumulative Statistics by User Index PFCAT,LO=S,DN=40. 
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SUMMARY REPORT 
DIRECTORY OF PERMANENT FILE DEVICE 40 SYS964 
INDIRECT ACCESS FILE HOLES 



yy/mm/dd. hh.mm.ss. 
PAGE 4 



CATALOG 


NUMBER 


TRACK 


HOLES 





8 


2 


52 


3 


1 


4 


6 


5 


36 


6 


1 


11 


111 


13 


4 


17 


1 


20 


12 


25 


12 


26 


28 


32 


142 


34 


39 


36 


603 



TOTAL 



1056 



NUMBER 
SECTORS 

501 

849 

35 

68 

745 

1 

1787 

187 

18 

204 

202 

321 

2095 

1225 

7026 

15264 



Figure 17-19. Cumulative Statistics for Entire Device 
PFCAT,LO=S,DN=40. (Continued) 
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SUMMARY REPORT 
DIRECTORY OF PERMANENT FILE DEVICE 40 SYS964 
PERMANENT FILE STATISTICS SUMMARY 



MASTER DEVICE USAGE 



yy/mm/dd. 
PAGE 



hh.irim.ss. 



GROUP TOTALS 



GROUP 



TOTAL 


TOTAL 


PERCENT OF 


FILES 


SECTORS 


TOTAL USAGE 


508 


16085 


24 


288 


6635 


10 


371 


11546 


17 


176 


5506 


8 


144 


4317 


6 


371 


7277 


10 


226 


5276 


7 


394 


9513 


14 



TOTAL 



IAF 



DAF 



TOTAL SECTORS 


66155 


25588 


40567 


TOTAL FILES 


2478 


2121 


357 


TOTAL USERS 


113 






AVE. FILES/USER 


21 


18 


3 


AVE. SEC /FILE 


26 


12 


113 


DEVICE TYPE - DI 








PERCENT DEVICE USAGE 


38 


15 


24 



DIRECT ACCESS DEVICE USAGE 



DEVICE 
NUMBER 

40 



DEVICE 
TYPE 

DI 



TOTAL 
FILES 

357 



TOTAL 
SECTORS 

40567 



PERCENT 
USAGE 

24 



Figure 17-19. Cumulative Statistics for Entire Device PFCAT,LO=S,DN=40. 
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Copy Archive File (PFCOPY) 

PFCOPY extracts files from an archive file and copies them to one or more files local to the 
job. The way the files are copied depends upon the parameter options selected. 

If MF=filename is specified, all the files extracted from the archive file are copied to one 
master file (filename) local to the job and they do not retain their permanent file names. 

In a secured system, the access level from the file's PFC entry is used to assign each file to 
be copied to an appropriate mass storage device. If no device can be found that allows the 
file to reside there, the PFCOPY utility skips the file and issues a diagnostic message. 

Dump Permanent File (PFDUMP) 

PFDUMP copies (dumps) permanent files to backup storage (an archive file). Dumps can be 
reloaded by the PFLOAD utility and can be accessed by the PFATC and PFCOPY utilities 
for cataloging and copying. PFDUMP issues messages to the dayfile indicating how many 
files were dumped and how many files were not dumped due to errors. The type of dump 
taken depends upon the purpose of the dump and is determined by the parameters selected. 
The denning characteristics of the three types of dumps follow. 

Types Characteristics 

Incremental OP=M is specified, and BD=yymmdd and BT=hhmmss are not specified, 
dump 

Partial dump Any dump that is not incremental and not full. 

Full dump No file selection options (date/time interval, file size, file names, etc.) 

except DN or TD are specified. 

If PFDUMP encounters an unrecoverable parity error while writing the archive file, several 
options are available via the K display. These options are described on the K display. If the 
option to continue the dump on another reel of tape is selected (KGO), it may not be 
possible to recover in such a way as to ensure that the PFLOAD utility can successfully 
read the archive tape. At least the archived file being written at the time of the error 
cannot be reloaded correctly. 
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PFDUMP in a Secured System 

In a secured system, PFDUMP determines the maximum range of access levels that can be 
dumped. If the LA and UA parameters have been used to select access level limits, these 
limits will be used. If no access level limits were selected, PFDUMP uses the device limits 
determined by taking the lowest lower access limit and the highest upper access limit of all 
the devices to be dumped. The range of possible access levels must be within the system 
access level limits or PFDUMP aborts the job and issues a diagnostic message. The range of 
possible access levels must also be within the equipment access level limits for the 
equipment (tape or mass storage) assigned to the archive file and verify file (if one is being 
written). If not within the equipment access level limits, PFDUMP aborts the job and issues 
a diagnostic message. 17 

Incremental Permanent File System Dump 

An incremental dump copies those permanent files modified after a specified date; that is, 
the OP=M option is specified together with the date (AD) and time (AT) options but 
BD=yymmdd and BT=hhmmss are not specified. Other options specified on the PFDUMP 
call can restrict the dump even further, but caution should be used when doing so if the 
dumps are used as part of an incremental reload scheme. 

For example, the command 

PFDUMP, OP=MI,AD=790101,AT=100000. 

causes only indirect access files (I parameter) modified after the specified date and time to 
be dumped. Normal procedure at a site is to follow up this dump with successive 
incremental dumps (usually with a periodic advancement of date and/or time). This 
produces a series of archive files containing successive updating of all files in the defined 
category. (These files can reside on one file: a multifile archive file.) The archive files can 
then be incrementally loaded (refer to the PFLOAD utility described later in this section) to 
return the most recently modified versions of the archived files to the permanent file system. 

Each incremental dump writes a record (or records) at the beginning of the archive file it 
creates. The record contains catalog images (refer to Catalog Image Record later in this 
section) of all files active on the devices) being dumped when the dump took place (files with 
no backup requirement (BR=N) are not included on the catalog image record unless OP=Y is 
specified). This enables a future incremental load of these files on a system or a device basis. 

An example of incremental dumping is given under Load Permanent File (PFLOAD) later in 
this section. 



17 The system access level limits are displayed as pan of the left screen header. The device access level limits (for mass storage) 
and equipment access level limits (for magnetic tape) are displayed on the EA display. Refer to the NOS Version 2 Operations 
Handbook for display formats. 
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Partial Permanent File System Dump 



A partial dump copies permanent files according to any specified option(s), 18 except those 
defining a full or incremental dump. For example, the command 



PFDUMP,OP=D. 

is a partial dump of all direct access permanent files. 18 Similarly, a dump of all files created 
(OP=C) or accessed (OP=A) after a certain date is a partial dump. 

A partial dump can dump files from either a certain device (DN or TD option) or all files in 
the system (DN and TD not specified) meeting the criteria of the specified options. 

Full Permanent File Dump 

A full dump copies all files in the system or those cataloged on a specified device; 18 no file 
selection options are specified except possibly DN (for a master device) or TD. 

PFDUMP File Interlocking 

PFDUMP interlocks a catalog track during the time it takes to dump all files whose PFC 
entries reside on that catalog track. No permanent file commands are processed on files 
whose PFC entries reside there until PFDUMP begins processing the next catalog track but 
jobs with direct access files attached are unaffected. For this reason, full permanent file 
dumps should not be done during heavy system use. An incremental dump provides 
adequate backup with less interference to the running system. PFDUMP skips any direct 
access files attached by jobs in write, modify, or append mode. Files attached in a 
non-writable mode or in update mode are dumped. 

PFDUMP in an MSE, Tape, or Optical Disk Alternate Storage Environment 

Because a large percentage of the total permanent file data typically does not reside on disk 
in an MSE, tape, or optical disk alternate storage environment, performing full backup 
dumps of file data is impractical. Whether PFDUMP dumps the data of a selected file 
depends on the user-specified backup requirement, the PFDUMP parameters selected, and 
the number of backup copies that exist. If these criteria do not require a data dump, only 
the file's PFC entry and permits are written to the dump file. 

The pertinent PFDUMP parameters are: 

Parameter Description 

OP=Y Treat all files as though the user specified a backup requirement of yes 

(BR=Y). 

COS=size PFC only size threshold. For all files with a file size greater than or equal 

to the specified size and for which the file's backup requirement is met by 
alternate storage copies, dump only the PFC and permits (do not dump the 
file data even if the data is available on disk). 

OP=S Suppress staging of file data from alternate storage if a data dump is 

selected and the file is not disk resident. 



18. Files with a backup requirement of none (BR=N) are not dumped unless OP=Y is specified. 
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The decision hierarchy for PFDUMP operations is as follows: 

• If OP=Y is specified, force the file's backup requirement to yes (BR=Y). 

• If the file backup requirement is none (BR=N), do not dump the file. 

• If the file size is less than the value specified by the COS parameter, select a data dump. 

• If the file size is greater than or equal to the value specified by COS: 

- and the backup requirement is media dependent (BR=MD) and no alternate storage 
copy exists, select a data dump. 

- and the backup requirement is media dependent (BR=MD) and at least one 
alternate storage copy exists, select a PFC and permits-only dump. 

- and the backup requirement is yes (BR=Y) and less than two alternate storage 
copies exist, select a data dump. 

- and the backup requirement is yes (BR=Y) and two or more alternate storage 
copies exist, select a PFC and permits-only dump. 

• If a PFC and permits-only dump is selected, write the file's PFC entry and permits to 
the dump file. 

• If a data dump is selected: 

- and the file is disk resident, write the file's PFC entry, permits, and data to the 
dump file. 

- and the file is not disk resident and staging is not suppressed (OP=S omitted), 
stage the file data to disk from alternate storage and write the file's PFC entry, 
permits, and data to the dump file. 

- and the file is not disk resident and staging is suppressed (OP=S specified), write 
the file's PFC entry and permits to the dump file. 

A typical set of PFDUMP parameters that a site might use for full and incremental backup 
dumps is: 

OP=Y not specified. 

COS set to some reasonably small value or zero (default is 0). 

OP=S specified. 
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If only tape alternate storage is in use and secondary VSNs have been created on all tape 
destaging operations, the OP=S option does not have to be specified since the backup 
requirement for all files is met. Specifying a nonzero value for COS may reduce the amount 
of staging activity following a permanent file reloading operation. However, files larger than 
or equal to the COS value will have to be staged back to disk in such a situation since only 
the RFC and permits will be reloaded. 

When a partial PFDUMP is performed to move files to a different user name, family, or 
system, it may be desirable to force a dump of the file data and clear the alternate storage 
information in the files' PFC entries depending on the situation. If files are being moved to 
a user name on the same family or to a different family on the same machine, there should 
be no need to dump the data of files residing only on tape alternate storage since the ability 
to stage files from tape does not depend on the family or user index under which a file is 
cataloged. If files are to be moved to a remote machine or if any of the files have an image 
on MSE or optical disk, the file data should be dumped and the alternate storage 
information should be cleared either by PFDUMP or on the subsequent PFLOAD. This can 
be accomplished by specifying the following parameters: 

OP=S not specified. 

COS=* set to select unlimited PFC only size threshold. 

OP=Z specified. 

Unlimited COS must be specified to select a data dump for all files having a backup 
requirement of yes (BR=Y). The OP=Z parameter could be specified on the PFLOAD instead 
of the PFDUMP, but it is recommended that it be done at dump time so that the operator 
does not have to remember to do it at load time. 



PFDUMP Protected Files 

When PFDUMP specifies purging of files (OP=P), files whose user indexes are greater than 
PGUI (default value is 300000 8 ) are not purged. This is done to prevent files such as critical 
recovery files, applications, and system utilities from being purged from the system due to 
lack of use. 



Load Permanent File (PFLOAD) 

PFLOAD loads archived files produced by the PFDUMP utility back into the permanent file 
system. The load can reestablish the permanent file system exactly as it was at the time of 
the dump, or can load only a desired subset of files on the archive file (as indicated by 
specified parameters). PFLOAD issues messages to the dayfile indicating how many files 
were loaded and how many files with errors were encountered. 

If LO=T (list all files processed) is specified, the listing produced is similar to that shown in 
figure 17-15. If LO=C (list all files in the catalog image record) is specified, the listing 
produced is similar to that shown in figure 17-20. 

The two types of loads available are incremental and nonincremental. An incremental load 
builds up (increments) an accumulation of the most recently modified versions of the files 
extracted from the archive files for loading. A series of archive files is read in the reverse 
order of creation. The CIR created by the most recent incremental dump is read and 
checked against the archived files on these files. If a file matches an entry on the CIR, that 
file is a candidate for loading. A nonincremental load does no CIR checking and uses only 
parameters specified on the PFLOAD call, if any, to select candidates for loading. 
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PFATC. FILES ON CATALOG IMAGE RECORD. 
ARCHIVE FILE CREATED yy/mm/dd. 
FILE USER ACCESS 
COUNT 





NAME 


INDEX 


1 


ARCPPD 


3320 


2 


SITRPT 


3320 


3 


LISTEXB 


3320 


4 


FSEPZ19 


3320 


5 


DECK3 


3320 


6 


SHORT 


3320 


7 


PFHELPR 


3320 


8 


PFACC 


3320 


9 


UPROC 


3320 


10 


MAILGRP 


3320 


11 


ACPD1 


3320 


12 


COPYRF 


3320 


13 


STAGE 


3320 


14 


CPD6 


3320 


15 


WORK 


3320 


16 


HAG 


3320 


17 


OLDTIME 


3320 


18 


PRC 


3320 


19 


Tl 


3320 


20 


FSEPROC 


3320 


21 


ARCGSY 


3320 


22 


ARCPCS 


3320 



FAMILY = SYS964. 
hh.mm.ss. ARCHIVE FAMILY = TEST. 
LAST ACCESS DEVICE 
DATE TIME NUMBER 

87/04/13. 15.22.31. 11 

87/04/13. 15.22.29. 

87/04/13. 15.22.29. 

87/04/13. 15.22.29. 

87/04/13. 15.22.29. 

87/04/13. 15.22.29. 

87/04/13. 15.22.29. 

87/04/13. 15.22.29. 

87/04/13. 15.22.30. 

87/04/13. 15.22.30. 

87/04/13. 15.22.30. 

87/04/13. 15.22.30. 

87/04/13. 15.22.30. 

87/04/13. 15.22.30. 

87/04/13. 15.22.30. 

87/04/13. 15.22.30. 

87/04/13. 15.22.30. 

87/04/13. 15.22.30. 

87/04/13. 15.22.31. 

87/04/13. 15.22.31. 

87/04/13. 15.22.31. 11 

87/04/13. 15.22.33. 11 



Figure 17-20. Catalog of Catalog Image Record 
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Catalog Image Record 



Each incremental dump (OP=M with AD or AT specified) writes a CIR at the beginning of 
the archive file on which the permanent files are dumped. The other types of dumps (full 
and partial) do not produce a CIR. The CIR is composed of 2-word entries for every 
permanent file that exists on the device(s) being dumped at the time of the incremental 
dump (not just the files that are included in the dump). 

The format of each entry is: 



59 




41 


35 




17 







filename 




userindex 




access count 


dn 


date time 



Field 



Description 



filename 
userindex 
access count 
dn 



date time 



Name of the permanent file. 

User index under which filename was cataloged. 

Number of times filename was accessed. 

Device number of the device on which filename resides if it is a direct 
access file and resides on a device other than your master device. If it 
resides on the master device, dn=0. If the file is indirect access, dn is 
ignored. 

Date and time filename was last accessed. 



When a file is loaded, this CIR information is placed in the permanent file catalog entry of 
the file being loaded. No other information can be changed over dumps and loads without 
updating the utility control date and time. 

Figure 17-20 contains a partial listing of the CIR. This listing can be obtained after a 
selective dump if the LO=C option is specified on a PFDUMP, PFLOAD, or PFATC call. A 
listing similar to the one in figure 17-15 can be obtained after a selective dump if the LO=T 
option is specified on a PFDUMP, PFLOAD, or PFATC call. In both cases, the headings 
vary but the format of the information is the same. 
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PFLOAD Selection Process 

Execution of the PFLOAD utility involves the following stages to determine which 
permanent files (from the archive file) should be loaded and on which devices they should 
reside. 

1. If the DN, TD, or DD parameters are used, the device number specified refers to a 
device in the running system and must exist in the family being loaded or PFLOAD 
aborts and issues this message: 

PFLOAD - DEVICE nn NOT FOUND. 

2. If the specified parameters logically imply that no files can be selected (such as OP=I, 
DN=n where n is not a master device), PFLOAD aborts and issues this message: 

PFLOAD - NO FILES SELECTED. 

3. The user index mask for selecting files (based on the device mask of the device specified 
by the DN and DI parameters) must be such that it is possible for some files to be on 
the archive file. There must be some common bits between the device mask of the 
archive file (written in the header record by PFDUMP) and the device mask of the 
device specified by the DN parameter for PFLOAD. If no common bits exist, PFLOAD 
aborts and issues this message: 

PFLOAD - SELECTED FILES NOT ON ARCHIVE FILE. 

4. For nonincremental loads, this stage of checking is bypassed and the entire archive file 
to be loaded is passed on to the next stage. 

The first step is to read the CIR from the most recent selective incremental dump file 
and place it on a random file. Then the archive files are read in the reverse order in 
which they were created (the most recently created file is read first). 

Each file on an archive file is checked against the CIR on the random file for a match of 
file name and user index (these fields describe a file uniquely in a family). If a match is 
found, the file is a candidate for loading and moves to the next stage of checking. Also, 
the file name and user index are zeroed out in the corresponding CIR entry to prevent 
subsequent loading of older versions of the same file. If a match is not found, the file is 
skipped because it has already been accepted (it appeared on a previous archive file and 
a match with the CIR was found) or has been purged. This process passes on only the 
latest versions of files obtained from the archive files. 

5. Only files that satisfy the criteria specified by the parameters on the PFLOAD 
command are selected (date/time, direct or indirect, user index, file name, and so forth). 
All other files are skipped. 
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The DN and TD parameters are used to select files from the archive file and to 
determine the device on which the files should be loaded. The device number specified 
refers to a device in the running system. 

Indirect access files, if selected, are always loaded on the appropriate master device 
(based on user index). Direct access files, if selected, are loaded on the device on which 
they previously resided. This is the device number contained in the file's PFC entry on 
the archive file. If the device number is 0, the file previously resided on the master 
device and will be reloaded there. 

It may not be possible to load a direct access file on the device on which it previously 
resided because the device number may no longer exist or its secondary mask may not 
allow it. (Refer to Device Masks earlier in this section for additional information.) 
Either of these situations can occur as a result of a reconfiguration of the permanent 
file system. In either case, if a direct access file cannot be loaded, the DD parameter is 
checked. If an alternate device is specified and its secondary mask allows it, the file is 
loaded on the alternate device. Otherwise, the OP=L option is checked (see step 7). If 
the OP=L option is not specified, PFLOAD skips the file and issues this message: 

PFLOAD - ALTERNATE DEVICE NOT FOUND, FN=f ilename,UI=userindex. 

The DN parameter is used to select files from the archive file in the following manner. 
If the device specified by DN (in the running system) is a master device, all files (direct 
and indirect) that would be cataloged on the master device (files with user indexes 
corresponding to that device's device mask) are selected. If the device specified by DN is 
not a master device, only direct access files that previously resided on the device (files 
with a device number of DN in their PFC entry) are selected. 

Similarly, the TD parameter is used to select files from the archive file in the following 
manner. If the device specified by TD is a master device, all files that were cataloged on 
it and all direct access files that previously resided on it are selected. (This corresponds 
to the way the TD parameter is processed by PFDUMP.) If the device specified by TD is 
not a master device, only direct access files that previously resided on it are selected. 

If neither the DN nor TD parameters are specified, all files meeting other selection 
criteria are selected. Specifying both DN and TD has the same effect as specifying only 
TD. 

In all cases, the device masks and master device status for the devices specified by the 
DN or TD parameters refer to the system in which PFLOAD is running, not the system 
in which the files were dumped. The user index and device number from the PFC on 
the archive file reflect the situation that existed at the time the files were dumped. 

If the OP=L option is specified, the device selected in step 6 (or the failure to select a 
device) for the residence of a direct access file is ignored. PFLOAD determines the 
device, among those devices where the file may reside (based on the device mask), 
which has the most available space. The OP=L option is not applicable to indirect 
access files since they must reside on the appropriate master device. 
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8. When a device has been selected to receive a direct access file, PFLOAD determines if 
the file will fit on the device. If the file is too large, PFLOAD skips the file and issues 
this message: 

PFLOAD - NO SPACE FOR FILE, FN=f ilename,UI=userindex. 

9. In secured systems, PFLOAD verifies before loading a file that the device where the file 
is to reside (as selected in steps 7 and 8) is appropriate for the file's access level. If the 
device is not appropriate, PFLOAD skips the file and issues this message: 

PFLOAD - NO DEVICE FOUND FOR FILE, FN=filename, UI=userindex. 

If PFLOAD is loading direct access files to the device with the most available space 
(OP=L), PFLOAD selects the device with the most space that also allows the required 
access level. 

10. PFLOAD determines the catalog track where the files to be loaded are to reside and 
builds an index file with a 1-word entry for each file on the track. The format of the 
entry is: 

m it 



filename 



userimfex 



PFLOAD checks each candidate file against this entry to determine whether it is in the 
permanent file system. If it is not, the file is loaded. If it is, loading depends upon the 
OP=R option. If OP=R was specified on the PFLOAD call, the archive duplicate 
replaces the one in the permanent file system. If OP=R was not specified, archive 
duplicates are skipped. 

Family Reconfiguration 

When reconfiguring a permanent file family by adding or subtracting devices, or changing 
the device masks, use the PFLOAD OP=L parameter to greatly simplify the procedure. 
Follow this sequence to reconfigure a permanent file family: 

1. PFDUMP,FM=familyname. 

2. Initialize all devices in the family. 

3. PFLOAD,OP=L,FM=familyname. 
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PFLOAD in an MSE, Tape, or Optical Disk Alternate Storage Environment 

In an MSE, tape, or optical disk alternate storage environment, an incremental load as 
described previously is the typical reload procedure. PFLOAD uses the CIR from the first 
incremental dump file to control the loading of file data and PFC and permit entries. For 
files with alternate storage copies, the files' data may not have been copied to the dump 
tape (refer to PFDUMP in an MSE, Tape, or Optical Disk Alternate Storage Environment 
earlier in this section for more information on how PFDUMP decides whether to dump a 
file's data or to dump only the file's PFC entry and permits). PFLOAD reloads only what 
was dumped by PFDUMP. Thus, if the file data was included on the dump tape, it will be 
reloaded to disk. If the file data was omitted from the dump tape, only the PFC and permit 
information for the files will be reloaded. Refer to section 11, MSE, or to section 12, Tape 
and Optical Disk Alternate Storage, for further information on how the PFLOAD utility is 
used in an MSE or tape alternate storage environment. 

PFDUMP/PFLOAD Example 

In this example, permanent files created and modified on three devices are dumped nine 
times. The action runs from March 1, 1982 (82.3.1) to March 10, 1982 (82.3.10). To keep 
things simple, the time of day is not shown. Before the last dump, one of the devices 
becomes inoperable. The example then shows how this device can be loaded from the 
archive tapes. Following are the three devices. 

Device Description 

40 A master device containing indirect access files only. Users with this master 
device have their direct access files written on 41 or 42. 

41 A master device containing indirect and direct access files. Direct access files 
cataloged on this device may be written on 42 or this device. 

42 A nonmaster device containing direct access files only. All files written on this 
device will be cataloged on 40 or 41. 

File names consist of a letter and a number. The letter identifies which device contains the 
catalog entry for this file (A=device 40 and B=device 41). The number is the same as the 
device on which the file is written. 

Each file name is followed by a date in parentheses. This indicates either the day on which 
the file was created or when it was last modified. 

Figure 17-21 outlines the creation, modifications, and dumps that were made. There is one 
particular action per column. The top of the column identifies the action and the key 
parameters used by the utility. If an archive tape is produced, it is shown at the bottom of 
the column. All files in the system are listed in each column. Those files affected by the 
action are underscored. 
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Figure 17-21. PFDUMP/PFLOAD Example (Sheet 1 of 3) 
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Figure 17-22. PFDUMP/PFLOAD Example (Sheet 2 of 3) 
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Figure 17-23. PFDUMP/PFLOAD Example (Sheet 3 of 3) 
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Actions during the 10 days in March in which the dumps and modifications were made run 
as follows: 

Date Action 

82.3.1 Five permanent files are created on this date. 

File A40 (indirect) is written on device 40 and cataloged on device 40. 
File A42 (direct) is written on device 42 and cataloged on device 40. 
File A41 (direct) is written on device 41 and cataloged on device 40. 
File B41 (indirect) is written on device 41 and cataloged on device 41. 
File B42 (direct) is written on device 42 and cataloged on device 41. 

82.3.2 DUMP 1. A fall permanent file system dump. No CIR is written on the 
archive file. 

82.3.3 Three files (A40, B41, and B42) are modified on this date. This is indicated 
by the modification date in parentheses following the file name. 

82.3.4 DUMP 2. This is an incremental dump of device 40 that specifies permanent 
files modified after 82.3.3. The files for this device are the ones listed on its 
catalog track. The utility scans this catalog which contains entries for files 
A40, A42, and A41. File A40 is on device 40 and the other two are on the 
devices indicated by their names. Only file A40, which was modified on 
82.3.3, qualifies for this dump. It is written on an archive tape after a CIE 
for this date (82.3.4). The CIR gives a current description of all five files in 
the permanent file system. 

82.3.4 DUMP 3. This is an incremental dump of device 41 that specifies all files 

modified after 82.3.2. The catalog for this device contains entries for files 
B41 and B42. Both files were modified on 82.3.3 and qualify for this dump. 
They are written on an archive file after a CIR for this date. 

82.3.4 DUMP 4. This is an incremental dump of device 42 that specifies all files 
modified after 82.3.2. The PFDUMP utility scans the catalogs on devices 40 
and 41 to locate the files on 42. One file, B42 (82.3.3), falls in this category. 

82.3.5 Three files are modified on this date. 

82.3.6 DUMP 5. This is an incremental dump of each of the three devices. All files 
modified after 82.3.4 are specified by the AD option. Since no DN is 
specified, all devices are dumped in turn, producing a dump tape with three 
archive files. 

82.3.7 DUMP 6. This incremental dump of device 42 specifies all files modified 
after 82.3.4. Since 42 is nonmaster, the dump routine scans the catalogs of 
the other two devices. 

82.3.8 Four files are modified on this date. 
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Date Action 



82.3.9 DUMP 7. An incremental dump of device 40 is made with AD=82.3.7. Two 

files qualify. 

82.3.9 DUMP 8. An incremental dump of device 41 is made with AD=82.3.7. The 
catalog on device 41 contains entries for files B41 and B42. File B41 is an 
indirect access file located on device 41, and file B42 is a direct access file 
located on device 42. Both files were modified after 82.3.7 and are dumped. 

82.3.10 DUMP 9. An incremental dump of devices 40, 41, and 42 is specified, but 
device 42 becomes inoperable before the dump is made. 

To reestablish permanent files on device 42 with the most recent modifications available, 
the device is first initialized and then incrementally loaded, beginning with the most recent 
incremental dump tape. Archive dump 8 is the most recent incremental dump tape and 
accordingly contains the most recent CIR. This reel is assigned first and then the CIR read 
onto a random file. The dump tapes are read in reverse order with each file on each tape 
being checked against the CIR. Dump tapes 2 and 3 are omitted since they do not involve 
device 42. 

For each catalog track on device 42 that is to receive file entries, PFLOAD builds and 
maintains an index file. Before each file can be loaded, PFLOAD checks the index file to see 
if the file has already been loaded. If it has, the archive duplicate is skipped; if not, the 
archive file is loaded and another entry goes into the index file. 
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After initialization of device 42, the loading runs as follows: 



Archive File 



Action 



DUMP8 tape 



The analyst assigns DUMP8 tape and enters the command: 

PFLOAD , T=DUMP8 , DN=42 . 

The utility reads the CIR from this tape onto a random file. It then 
looks for files for device 42 on this tape. B42 qualifies, and its entry 
in the CIR is removed. The file B42 is loaded on device 42. The 
catalog of this file on device 41 is created. After loading this file, the 
utility makes an entry in the index file as follows: 



CIR(82.3.9) 



B41(82.3.8) 
B42(82.3.8) 



B42 


userindex 



D0MP7 tape 



CIR( 82.3.9) 



A40(82.3.8) 
A41(82.3.8) 



DUMP6 tape 



CIR{82.3.7) 



B42(82.3.5) 



DDHP5 tape 



CIR<82.3.6) 



A40(82.3.5> 
B41( 82.3.5) 
B42(82.3.5) 



DUMP4 tape 



CIR(82.3.4) 



B42(82.3.3) 



The utility then requests the next reel. 

The analyst assigns this tape, and the utility reads the archive file 
and checks it against the CIR loaded from DUMP8 above. No match 
is found. The next reel is requested. 



This tape is assigned and then compared with the CIR. B42 is a file 
from device 42. However, its entry in the CIR was removed when it 
was read from DTJMP8. 



This tape is assigned and then compared with the CIR. B42 is from 
device 42 but it has already been removed from the CIR and the 
utility skips this version. 



This tape is assigned and compared with the CIR originally read 
from DUMP8 tape. It has been removed from the CIR and this file 
is skipped. 
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Archive File 



Action 



DUMP1 tape 



A40(82.3.1) 



A42(82.3.1) 
A4K82.3.1) 
B41{82.3.1) 
B42(82.3.1) 



This tape, produced by a full dump, contains all the files that were 
on the permanent file system when the dump was made (82.3.1). 
These files are checked against CIR (82.3.9). A match is found with 
A42. This file is loaded. 



Device 42 now has the same files with the same update status that 
they had on 82.3.9 when the last incremental dump was made. 



Release Disk Space (PFREL) 

The PFREL utility releases the disk space of files that reside on alternate storage if the 
files' backup requirements are met. 19 PFREL can be called directly or used with a file 
selection utility such as GENPFD in the following sequence. 

First, execute PFREL with inhibit processing (IP parameter) and the summary file (S 
parameter) selected. Files can be excluded by specifying selection parameters. In particular, 
OP=A can be used with BD and BT to exclude files that have been recently accessed. For 
this example, enter the following command. 

PFREL , IP , S , OP=A, BD=yymmdd, BT=hhmmss , FM=f amilyname . 

Second, execute the file selection utility GENPFD using the summary file generated in step 
1 as input. A utility directives file will be generated containing the UI and PF parameters 
for the selected files. Refer to section 12, Tape and Optical Disk Alternate Storage, for a 
description of the GENPFD utility. 

Third, reexecute PFREL without specifying the IP parameter and using the utility 
directives file generated in step 2 as input. For this example, enter the following command. 

PFREL, I=dirfile. 

The PFREL utility will not release the disk space of files cataloged on user name SYSTEMX 
or on the MSE user names SUBFAMO through SUBFAM7 even if the selection criteria are 
met. 



19. Refer to PFDUMP in an MSE, Tape, or Optical Disk Alternate Storage Environment earlier in this section for a discussion of 
backup requirements. 
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Several utility programs control queued input and output files and system, account, error 
log, and binary maintenance log dayfiles. The utility programs are divided into the 
following two groups, according to the type of selective processing they do. 

• The queued file utilities are 10 utilities under the control of the queued file supervisor 
program QFSP. These utilities select for processing queued files or dayfiles that share 
certain characteristics you specify such as device residence, file destination, and job 
sequence name. 

• The dayfile dumping utilities are five independent utilities that dump all or selected 
parts of the active system dayfile, account dayfile, error log, or binary maintenance log. 
These utilities each process the contents of a single file according to criteria you specify. 

Queued File Utilities 

The names and functions of the queued file utilities follow. The rest of this section includes 
detailed information about the call and operation of each utility. 



Utility 



Description 



DFLIST lists dayfiles that have been made permanent files by the DFTERM utility. 

DFTERM Terminates an active or inactive dayfile and retains it as a direct access 
permanent file. 

LDLIST Lists queued files present on a QDUMP dump tape. 

QALTER Alters routing information associated with active queued files; purges 

active queued files. 

QDUMP Dumps queued files to a tape or disk. 

QFTLIST Lists detailed information about active queued files. 

QLIST Lists inactive queued files. 

QLOAD Loads files dumped by QDUMP as queued files. 

QMOVE Moves queued files from one disk device to another. 

QREC Deactivates or activates selected queued files; purges inactive queued files. 
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Calling the Queued File Utilities 

All queued file utility operations, except DFLIST, LDLIST, and QLIST, can be initiated 
through console input to a K display. All queued file utilities except DFLIST, DFTERM, 
QALTER, and QFTLIST can be initiated through entries made at the system console (under 
DIS or DSD control, including procedure files), card input (batch), or terminal entries. 
DFTERM, DFLIST, QALTER, and QFTLIST operation can be initiated only through entries 
made at the system console. However, in all cases, for batch and terminal input, you must 
be validated for system origin privileges, the system must be in debug mode, and you must 
observe certain parameter order dependencies. Since LDLIST, QDUMP, and QLOAD 
require preassignment of the dump file, only DIS, batch, or terminal input is appropriate for 
these utilities. DFLIST, DFTERM, LDLIST, QDUMP, QFTLIST, and QLIST can access files 
on an inaccessible device. QMOVE can read files from an inaccessible device, but the job 
may get rolled out if QMOVE attempts to move files to another inaccessible device. If this 
happens, drop the job and attempt a QDUMP. 

Console Input 

Input from a console through a K display requires the following sequence of entries and 
responses. These procedures do not apply to DFLIST, QLIST, or LDLIST, because K 
displays are not available for these utilities. 

1. Call QFSP by entering: 

X.QFSP. 

The B,0 display indicates the job sequence name of QFSP. To the right of the entry this 
message appears: 

REQUEST *K* DISPLAY 

2. Activate the K display for that control point by entering: 

K, jsn. 

Parameter Description 



jsn Job sequence name of QFSP as specified on the B,0 display. 

The QFSP K display shown in figure 18-1 appears on the left screen. Instructions on 
the display describe how to select the desired utility. 
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K . QFSP . j Sll 

hh.mm.ss. yy/mm/dd. CDC NETWORK OPERATING SYSTEM 
MID=AA NOS version 

QUEUED FILE SUPERVISOR 



ENTER K. UTILITY. 

UTILITY DESCRIPTION 

QDUMP QUEUED FILE DUMP PROCESSOR. 

QLOAD QUEUED FILE LOAD PROCESSOR. 

QMOVE QUEUED FILE MOVE PROCESSOR. 

QREC PROCESS QUEUED FILES. 

DFTERM TERMINATE DAYFILES . 

QFTLIST LIST ACTIVE QUEUED FILES. 

QALTER ALTER ACTIVE QUEUED FILES. 



Figure 18-1. QFSP K Display (Left Screen) 
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3. Select the desired utility by entering: 

K. utility 
Parameter Description 



utility One of the utilities shown in the K display, figure 18-1. 

The parameters available under the chosen utility appear on the left screen as the 
initial K display for the utility. Figures 18-6, 18-14 through 18-16, 18-19 through 18-21, 
18-23 through 18-25, and 18-28 through 18-30 exhibit initial K displays for the various 
utilities. Different parameters are available with the different utilities. (Refer to 
Description of Queued File Utilities later in this section.) 

It is also possible to call each utility directly by substituting the following procedure for 
steps 1, 2, and 3. 

a. Call the desired utility by entering: 

X. utility 

Parameter Description 

utility One of the utilities shown in figure 18-1. 

The B,0 display indicates the job sequence name of the chosen utility. This 
message also appears: 

REQUEST *K* DISPLAY 

b. Activate the initial K display for the chosen utility by entering: 

K, jsn. 

Parameter Description 

jsn. Job sequence name as specified on the B,0 display. 

c. Commands and directives are available to aid in the use of the utilities and direct 
processing. A right screen display lists and defines the commands and directives. 
Activate this K display by entering: 

KK. 

Figures 18-2 through 18-5 show the resultant QFSP K display on the right screen. 
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K. utility jsn 



K DISPLAY COMMANDS PAGE 1 OF 4 

GO PROCEED WITH PROCESSING. 

OUT RELEASE FILE SPECIFIED BY *L* PARAMETER TO PRINTER. 

RESET RESET PARAMETERS TO DEFAULT VALUES. 

STOP TERMINATE INPUT, END RUN. 

+ PAGE LEFT SCREEN FORWARD. 

PAGE LEFT SCREEN BACKWARD. 

( PAGE RIGHT SCREEN FORWARD. 

) PAGE RIGHT SCREEN BACKWARD. 



Figure 18-2. QFSP K Display (Right Screen) (Page 1 of 4) 



K DISPLAY COMMANDS PAGE 2 OF 4 

CLEAR SET BOTH SCREENS TO FIRST PAGE OF K DISPLAY. 

(QREC, DFTERM, QFTLIST, QALTER) . 
ERROR TOGGLE STATUS OF ERRORED FILE PROCESSING. 

(QDUMP, QLOAD, QMOVE) . 
FAMILY IF ENTERED, ENTRIES WILL BE MADE IN THE FOT FOR 

THE INACTIVE FAMILIES AND THE FILES WILL BE QUEUED. 

(QREC, QLOAD, QMOVE) . 

LID IF ENTERED, ENTRIES WILL BE MADE IN THE LID TABLE 

FOR THE INACTIVE LIDS AND THE FILES WILL BE QUEUED. 
(QREC, QLOAD, QMOVE) . 

LIST DISPLAY JSN-S OF ACTIVE/ INACTIVE QUEUED FILES ON 
RIGHT SCREEN. (QREC, DFTERM, QALTER, QFTLIST) . 

REWIND IF ENTERED, DUMP/LOAD FILE WILL BE REWOUND WHEN 
*GO* COMMAND IS ENTERED. (QDUMP AND QLOAD) . 



Figure 18-3. QFSP K Display (Right Screen) (Page 2 of 4) 
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DIRECTIVE FORMATS 




PAGE 3 OF 4 


DA=YYMMDD 


PROCESS 


THIS DATE ONLY. 


DA= YYMMDD- YYMMDD 


PROCESS 


ALL DATES IN SPECIFIED RANGE. 


DA=ALL 


PROCESS 


ALL DATES. 


UI=XXXXXX 


PROCESS 


THIS UNDER INDEX ONLY. 


UI=XXXXXX-YYYYYY 


PROCESS 


ALL INDICES IN SPECIFIED RANGE. 


TUI=XXXXXX 


PROCESS 


THIS USER INDEX ONLY. 


TUI=XXXXXX-YYYYYY 


PROCESS 


ALL INDICES IN SPECIFIED RANGE. 


FS=XXXXXX 


PROCESS 


THIS FILE SIZE ONLY. 


FS=XXXXXX-YYYYYY 


PROCESS 


ALL SIZES IN SPECIFIED RANGE. 




777777B 


INCLUDES ALL LARGER SIZES. 


ID=XX 


PROCESS 


THIS ID ONLY. 


ID=XX-YY 


PROCESS 


ALL ID-S IN SPECIFIED RANGE. 


FC=F1 


PROCESS 


THIS FORMS CODE ONLY. 


FC=F1/F2/F3 


PROCESS 


ALL FORMS CODES IN LIST. 


FC=F1-F2 


PROCESS 


ALL FORMS CODES IN THE RANGE. 



Figure 18-4. QFSP K Display (Right Screen) (Page 3 of 4) 



DIRECTIVE FORMATS 






PAGE 4 OF 4 


DS=DT FILE 


DESTINATION=DISPOSITION 


TYPE. 


DS 


DESCRIPTION 








BC 


BATCH. 








RB 


REMOTE BATCH. 








DT 


DESCRIPTION 


DT 




DESCRIPTION 


IN 


INPUT. 


PU 




PUNCH. 


PL 


PLOT. 


PR 




ANY PRINTER. 


P2 


512 PRINTER. 


LR 




580-12 PRINTER. 


LS 


580-16 PRINTER. 


LT 




580-20 PRINTER. 


LX 


5870 NIP. 


LY 




5970 NIP. 


WT 


WAIT QUEUE. 


SF 




SPECIAL QUEUE TYPES. 


ALL 


ALL QUEUES. 


PRINT 


ALL PRINT QUEUES. 


NONE 


NO QUEUES. 









Figure 18-5. QFSP K Display (Right Screen) (Page 4 of 4) 
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Following is a list of the queued file utility commands included on the first two pages of 
the QFSP K display (refer to figures 18-2 and 18-3) and a description of each. 

Command Description 



CLEAR 



ERROR 



FAMILY 



GO 



LID 



Used in conjunction with the LIST command; returns the right screen 
K display to the list of processing commands initially displayed (refer 
to figure 18-2) and returns the left screen K display to the first page. 

If the QDUMP utility is active, enabling this command causes files on 
which unrecoverable read errors were encountered to be dumped with 
the errors listed on the output file. Disabling this command causes 
these files to be ignored. The default under QDUMP is enabled. 

If the QLOAD utility is active, enabling this command causes such 
files to be loaded with the errors listed on the output file. Disabling 
the command causes such files to be ignored. The default under 
QLOAD is disabled. 

If the QMOVE utility is active, enabling this command causes such 
files to be moved with errors listed on the output file. Disabling this 
command causes such files to be ignored. The default under QMOVE 
is disabled. 

Entry of this command toggles setting of this command. 

Specifies whether or not files are queued when creation or destination 
families are not active [not in family ordinal table (FOT)]. Default is 
not to queue these files. When the FAMILY command is specified, 
entries are made in the FOT for inactive families and the files are 
queued. This command applies only to the QLOAD, QMOVE, and 
QREC utilities. 

Directs the active utility to proceed with the processing of the entered 
parameters. When the processing is complete, the left screen K 
display is reset to the default values. 

Specifies whether or not files are queued when the creation logical 
identifier (LID) is not in the LID table. Default is not to queue these 
files. When the LID command is specified, entries are made in the 
LID table and the files are queued. This command applies only to the 
QLOAD, QMOVE, and QREC utilities. 
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Command Description 



LIST 



LIST=qft 



OUT 



RESET 
REWIND 

STOP 

+ 

( 

) 



If the DFTERM utility is active, this command displays a list of all 
permanent dayfiles (refer to figure 18-7). The list of files displayed is 
also written on the output file specified by the DFTERM L parameter. 

If the QALTER or QFTLIST utility is active, this command displays a 
fist of active queued files on the right screen K display (refer to figure 
18-11). The list of files is also written on the output file specified by 
the QALTER or QFTLIST L parameter. 

If the QREC utility is active, this command displays a fist of inactive 
queued files on the right screen K display (refer to figure 18-31). The 
list of files displayed is also written on the output file specified by the 
QREC L parameter. 

Displays detailed information about the active queued file at QFT 
ordinal qft on the right screen K display (refer to figure 18-12) and 
writes the information to the output file specified by the QALTER or 
QFTLIST L parameter. This form of LIST is accepted only by 
QALTER and QFTLIST. 

Sends the output file specified by the L option of each utility to the 
print queue for immediate printing. Any information that has been or 
is currently displayed on the right screen K display via the LIST 
command is also included with the disposed output. In addition, if the 
LIST command is currently active, the list displayed on the right 
screen is disposed, and the initial right screen K display shown in 
figure 18-2 is returned automatically. 

Resets all options displayed on the left screen K display to then- 
default values. 

Rewinds the load or dump file specified by the FN parameter before 

processing. This command applies only to the QLOAD and QDUMP 

utilities. 

Terminates the active utility and ends the K-display interaction. 

Pages the left screen forward. 

Pages the left screen backward. 

Pages the right screen forward. 

Pages the right screen backward. 



The third and fourth pages of the QFSP K display (refer to figures 18-4 and 18-5) show 
directive formats. These directives are described in detail under Parameters for the 
Queued File Utilities later in this section. 
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4. Select the desired parameters by entering: 

K.opt 1 =val 1 ,opt 2 =val 2 , . . . , opt n =val n 

The optpvalj are selected from the parameter list on the initial K display for the chosen 
utility. 

The option parameter entries are issued to the job dayfile, which is included in the 
output file specified by the L parameter for each utility (refer to Parameters for the 
Queued File Utilities later in this section). 

If the FM parameter is specified for QDUMP, QMOVE, or QREC (indicating the 
processing of queued files for only the specified family of devices), the initial left screen 
display (refer to figures 18-14 through 18-16, 18-23 through 18-25, and 18-28 through 
18-30) is replaced by the secondary left screen display (refer to figures 18-17, 18-26, and 
18-32). This display closely resembles the initial left screen for the utility but restricts 
processing to the family of devices specified. Each device in the specified family 
containing inactive queued files is indicated. In addition, any parameter entered for the 
utility is reflected in this display. Parameters not entered remain at default values. 

If the FM parameter is not specified, the initial K display remains on the left screen. 
However, the display is modified to reflect the parameters entered. Parameters not 
entered remain at the default values. 

The displays are modified in this manner to provide an opportunity to double-check the 
entry. If it is necessary to modify the entry, reenter those parameters that are to be 
changed. Entry of incorrect data causes an error message to appear at the bottom of the 
left screen K display. In this case, the portion of the entry up to the point where the 
error was encountered is processed; the remainder of the entry (from left to right) is 
ignored. 

5. Initiate execution by entering: 

K.GO. 

When processing is complete, the left screen K display is reset to default values, the 
message 

utility complete (utility is the name of the utility processed) 

appears at the bottom of the screen, and the right screen returns to the original display. 

6. Terminate use of the chosen utility and end K-display interaction by entering: 

K.STOP. 

An output file is generated indicating the queued files or dayfiles processed and any 
charges that were made to these files. Examples of output files generated by each 
utility are shown in figures 18-7, 18-18, 18-22, 18-27, and 18-33. 
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It is also possible to call each utility and specify appropriate parameters without using K 
displays; this is the only way to call DFLIST. You do this using a single keyboard entry in 
the following format. 

X. utility (opt 1 =val 1/ opt 2 =val 2 opt n =val n , I=f ilename, PO=N) 

Parameter Description ____ 



utility Any queued file or dayfile utility. 

optpvalj Parameters (refer to Parameters for the Queued File Utilities later in this 

section). 

I=filename Name of alternate input file (optional). This file may contain K-display 

utility commands (GO, STOP, RESET, and so on) and parameters. 

PO=N Specifies that no K-display input is allowed. The use of the PO=N 

parameter and proper parameter selection allows the utility to run 
without additional operator intervention. This parameter is not needed 
and should not be entered for QLIST, LDLIST, and DFLIST. 

The specified utility processes parameters on the command before the alternate input file, if 
any. If the utility is QLIST, LDLIST, or DFLIST or if PO=N is specified, the requested 
queued file/dayfile processing proceeds after all command and alternate input file 
parameters have been processed (unless a STOP command is encountered on the alternate 
input file). If PO=N is omitted from the command and the utility is not one previously 
mentioned, the utility requests the K display after processing the command and alternate 
input file (unless a STOP command is encountered on the alternate input file). The K 
display then reflects the status of all parameters after processing of the command and 
alternate input file is complete. If the utility encounters an error while processing the 
command or alternate input file, a request for the K display appears on the DSD B,0 
display (except for QLIST, LDLIST, and DFLIST). You may then activate the K display, 
enter the correct parameters, and continue processing. However, if errors are encountered 
and the utility was invoked by a nonsystem origin job, a message is issued to the dayfile, 
and utility processing is terminated. 



18-10 NOS Version 2 Analysis Handbook 60459300 U 



Queued File Utilities 



Batch Input 

To call the utilities from a batch job, you must be validated for system origin privileges, and 
the system must be in debug mode. Use the following sequence of commands to call a utility. 

ujn. 

USER, username, password, familyname. 

utility, opt 1 =val 1 ,opt 2 =val 2 , . . . , opt n =val n , I=filename, PO=N. 

Parameter Description 



utility Any of the following utilities: QREC, QDUMP, QLOAD, QMOVE, QLIST, 

or LDLIST. 

opt^valj Parameters (refer to Parameters for the Queued File Utilities later in this 

section). 

I=filename Name of alternate input file (optional). This file may contain K-display 

utility commands (GO, STOP, RESET, and so on) and parameters. 

PO=N Specifies that no K-display input is allowed. The use of the PO=N 

parameter and proper parameter selection allows the utility to run 
without additional operator intervention. This parameter is not needed 
and should not be entered for QLIST or LDLIST. 

The DFLIST, DFTERM, QALTER, and QFTLIST utilities cannot be called from a batch job. 
They must be initiated from the system console. 

Terminal Input 

The format of terminal input for calling the queued file utilities is substantially the same as 
that for batch input. You must be validated for system origin privileges, and the system 
must be in debug mode. At login, you enter the batch subsystem, call the desired utility, 
and enter the appropriate parameters with the command: 

utility, opt 1 =val 1 , opt 2 =val 2 , opt n =val n , I=f ilename, PO=N 

The utility, opt=val, I=filename, and PO=N parameters are the same as described for batch 
input. 

Parameters for the Queued File Utilities 

Tables 18-1 and 18-2 specify the parameters accepted by each queued file utility. (DFLIST 
is not included because it does not accept any parameters.) An X indicates that a parameter 
is accepted; a blank indicates that a parameter is not accepted. Refer to the descriptions of 
parameters following the table for more information. 
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Table 18-1. Queued File Utility Parameters (DFTERM through QFTLIST) 



Parameter 


DFTERM 


LDLIST 


QALTER 


QDUMP 


QFTLIST 




BC 




X 


X 


X 


X 




DA 




X 




X 






DD 




X 










DF 




X 


X 




X 




DN 


X 




X 


X 


X 




FC 




X 


X 


X 


X 




FM 


X 




X 


X 


X 




FN 




X 




X 






FS 




X 




X 






FT 


X 












FU 




X 




X 






ID 




X 


X 


X 


X 




JSN 






X 


X 


X 




L 


X 


X 


X 


X 


X 




LA 




X 


X 


X 


X 




LD 




X 


X 


X 


X 




LO 






X 




X 




MI 




X 




X 






NAL 






X 








NDC 






X 








NDF 






X 








NEC 






X 








NF 




X 




X 






NFC 






X 








NID 






X 








NLD 






X 








NM 


X 












NPR 






X 








NRC 






X 








NUN 






X 








OP 


X 




X 








PO 


X 




X 


X 


X 




RB 




X 


X 


X 


X 




sc 




X 










TF 








X 






TP 








X 






TUI 




X 




X 






UA 




X 


X 


X 


X 




Ul 




X 




X 






UJN 






X 




X 




UN 






X 




X 
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Table 18-2. Queued File Utility Parameters (QLIST through QREC) 
Parameter QLIST QLOAD QMOVE QREC 



BC 


X 


X 


X 


X 


DA 


X 


X 


X 


X 


DD 




X 


X 




DF 




X 


X 




DN 


X 




X 


X 


FC 


X 


X 


X 


X 


FM 


X 




X 


X 


FN 




X 






FS 


X 


X 


X 


X 


FT 










FU 


X 


X 


X 


X 


ID 


X 


X 


X 


X 


JSN 


X 


X 


X 


X 


L 


X 


X 


X 


X 


LA 


X 


X 


X 


X 


LD 


X 


X 


X 


X 


LO 










MI 


X 


X 


X 


X 


NAL 










NDC 










NDF 










NEC 










NF 




X 






NFC 










NID 










NLD 










NM 










NPR 










NRC 










NUN 










OP 




X 


X 


X 


PO 




X 


X 


X 


RB 


X 


X 


X 


X 


SC 




X 






TF 




X 


X 


X 


TP 






X 




TUI 


X 


X 


X 


X 


UA 


X 


X 


X 


X 


UI 


X 


X 


X 


X 


UJN 










UN 
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Description of Queued File Utility Parameters 



Parameter 


Descripl 


ion 


BC=dt 


Queued files destined for local batch devices can be selected for 




processing by disposition type (dt). 




dt 

ALL 


Description 




Files of all disposition types. 




IN 


Input files. 




LR 


580-12 printer files. 




LS 


580-16 printer files. 




LT 


580-20 printer files. 




LX 


5870 printer files. 




LY 


5970 printer files. 




NONE 


No files. 




PH,PU 


Punch files. 




PL 


Plot files. 




PR 


Files that can print on any printer. 




PRINT 


All printer files. 




P2 


512 printer files. 




SF 


Installation-defined special files; cannot be used with 
QALTER or QFTLIST. 




WT 


Queued files with a wait disposition. 



The BC entry can be specified more than once, with each successive 
entry reversing the previously established condition. By default, all 
disposition types are selected; so any entry actually clears the 
automatic selection. For example, BC=PU means local batch-destined 
punch files are not to be processed. However, a second BC=PU entry 
reenables processing of local batch-destined punch files. 

If BC=ALL or BC=NONE is specified, processing of all disposition types 
is either enabled or disabled, respectively. If all disposition types are 
currently enabled, entering BC=ALL has no effect. Likewise, entering 
BC=NONE has no effect if all disposition types are disabled. 
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Parameter 



Description 



DA=yymmdd 



DD=dn 



DF=familyname 



DN=dn 



Processing date in the form year month day. If one date is specified, 
only queued files created on that day are processed. If two dates, 
separated by a hyphen, are specified (for example, 820130-820213), all 
queued files created within the specified range (including the end 
dates) are processed. If DA=ALL is specified, all queued files are 
processed. If this parameter is omitted with utilities other than QLIST, 
queued files created five days prior to the current date are processed. If 
this parameter is omitted with QLIST, all inactive queued files, 
regardless of creation date, are processed. 

Destination device to which files are to be loaded or moved. The DF 
parameter must be specified before the DD parameter. If DF is 
specified, DD must also be specified. Since QMOVE requires DF, DD 
must also be specified. 

Family of devices to which files are to be loaded or moved. With 
QMOVE, this parameter must be specified. 

With QALTER or QFTLIST, DF must be used with the UN parameter. 
The utility will process files belonging to the remote terminal identified 
by these parameters. 

The 1- or 2-digit device number (0 through 77 8 ). With utilities other 
than DFTERM, this parameter specifies the device to be processed, 
dumped, or loaded. The FM parameter must be specified before the DN 
parameter. Default is all devices. 

With DFTERM, this parameter specifies the device on which the 
inactive dayfile resides or on which the new dayfile will reside if the 
active dayfile is terminated. Default is the device on which the current 
dayfile resides. If the FM parameter is specified, the default for DF is 
zero. 
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Parameter 



Description 



FC=fc 



Forms code for output files considered for processing. This parameter 
does not deselect input files. 



fc 



Description 



ALL 
fcj/ft^/ft^ 

fci-fe 2 



All files are considered for processing regardless of 
forms codes. 

fcj is 2 alphanumeric characters or **, indicating 
null forms codes. Up to three forms codes or ** can 
be specified; files with the specified forms code(s) are 
considered for processing. 

fcj is 2 alphanumeric characters or **. The 6-bit 
display code value of fcj must be less than or equal to 
the 6-bit display code value of fc 2 . fc 2 can be ** only 
if fc x is also **. Files in the range fc x through fc 2 are 
considered for processing; if fc x equals **, files with 
no forms code are (also) considered for processing. 

A subsequent FC entry replaces any FC entry previously made. Default 
is to consider all files for processing regardless of forms codes. 

FM=familyname Name of family to be processed. Default is to process all queued files on 
all devices in all families. 

With DFTERM, this parameter specifies the family of devices on which 
the inactive dayfile resides or on which the new dayfile will reside if the 
active dayfile is terminated. If an active dayfile is terminated, default is 
the same family as that in which the dayfile being terminated resides. 

FN=filename File name of dump or load file. Default is FN=QFILES. 

FS=x File size in PRUs. The value can be entered as a single file size 

(FS=100) or as a range of file sizes (FS=10-400). x < 777777 8 . Default is 
to consider all files for processing regardless of file size. 
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Parameter 



Description 



FT=t 



FU=familyname 



ID=id 



JSN=jsn 



L=outfile 
LA=level 

LD=lid 



Type of dayfile to be terminated by the DFTERM utility. 
t Description 



ACCOUNT 

DAYFILE 

ERRLOG 

MAINLOG 



Account dayfile. 
System dayfile. 
Error log. 
Binary maintenance log. 



This parameter causes the FM and DN parameters to be updated to 
reflect the current family and device number of the dayfile specified by 
FT. Default is FT=DAYFILE. 

Name of family under which the queued files to be processed were 
created. Queued files created by users of one family can reside on 
nonremovable devices of another family. The FM parameter specifies 
the family of devices that will be searched for queued files created by 
users validated in the family specified by the FU parameter. Default is 
to process queued files created by users in all families. 

The 1- or 2-digit octal number (0 through 67 8 ) specifying that only local 
batch-destined queued files assigned to that identifier are to be 
processed. This parameter does not deselect remote batch-destined 
files. If two identifiers, separated by a hyphen, are specified (for 
example, ID-6-30), any queued file with an identifier in the specified 
range (including the end points) is processed. Default is to process all 
queued files regardless of identifier. 

The 4-character job sequence name of queued files to be processed, 
dumped, loaded, or moved. At most, five job sequence names can be 
specified. If a job sequence name is specified more than once, it is 
removed from the list. Default is to process all queued files regardless 
of job sequence name. 

The 1- to 7-character name of the file to receive output. Default is 
L=OUTPUT. Specify L=0 if no output file is needed. 

The 1- to 7-character name that specifies the lower limit of the range of 
access levels to process. If this parameter is specified, the UA 
parameter must also be specified. If neither LA nor UA is specified, the 
default is that all access levels are selected. 

The 3-character logical identifier of the mainframe with which the file 
is associated. LD=0 means process all files without LIDs. A subsequent 
LD entry replaces any LD entry previously made. Default is to process 
all queued files regardless of logical identifier. 
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Parameter 

LO=opt 



Description 



MI=id 



NAL=level 



NDC=dt 



List option associated with the output file specified by the L 
parameter. 

opt Description 



F All routing information for each file. 

S Condensed listing of each selected queued file. 

The 2-character machine identifier indicating the mainframe on 
which the queued files to be processed currently reside. If MI=ALL 
is specified, any queued file residing on any mainframe is processed. 
The MI entry is cleared if previously specified; that is, specifying two 
identical MI entries is the same as not specifying any at all. If the MI 
entry is cleared on the K display, the id is not checked. Default is the 
machine identifier of the mainframe where the utility is being run. 

QALTEE can change the access level of a queued file. The new access 
level must be within the origin type limits for the file and within the 
device limits of the device on which the file resides. This parameter 
is restricted to users with security administrator privileges. 

QALTER can change a print file's disposition type while the file is in 
the queue. New disposition types that can be selected include the 
following. 



dt 


Description 


LP 


Any printer. 


Lit 


580-12 printer. 


LS 


580-16 printer. 


LT 


580-20 printer. 


LX 


5870 printer. 


LY 


5970 printer. 


NONE 


No device code specified. 


PR 


Any printer. 


P2 


512 printer. 



NDF=familyname 



New destination family name associated with selected output files. 
This parameter is meaningful only when altering files routed to or 
changed to remote batch. A subsequent NDF entry replaces any 
previous NDF entry. Default is no change in destination family 
name. 
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Parameter 



Description 



NEC=ex 



QALTER can change an output file's external characteristics. New 
external characteristics that can be selected include the following. 

For print files: 

ex Description 

A4 1 ASCII graphic 48-character set. 

A6 ASCII graphic 63/64-character set. 

A9 ASCII graphic 95-character set. 

B4 1 CDC graphic 48-character set. 

B6 CDC graphic 63/64-character set. 

For punch files: 

ex Description 

AS Punch ASCII. 

PB Punch system binary. 

PH Punch 026 mode. 

P8 Punch 80-column binary. 

P9 Punch 029 mode. 

For plot files: 

ex Description 



T6 Transparent 6 bit. 
T8 Transparent 8 bit. 



NF=n 



NFC=fc 



Decimal number of media files to skip. A media file contains all queued 
files that are dumped by one QDUMP operation. Each of these dumped 
queued files exists as a record on the media file. If two QDUMP 
operations are performed, the dumped queued files exist as records on 
two files. This parameter can be used in conjunction with the SC 
parameter. Default is 0. 

Two alphanumeric characters or ** (null forms code) specifying the new 
forms code associated with selected output files. The NFC entry is 
cleared if previously specified; that is, specifying two identical NFC 
entries is the same as not specifying any at all. Default is no change in 
forms code. 



1. Not supported. Provided for NOS/BE compatibility. 
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Parameter 



Description 



NID=id 



NLD=lid 



NM=filename 



NPR=p 



NRC=c 



NUN=username 



The 1- or 2-digit number (0 through 67 8 ) specifying the new file 
identifier associated with selected output files. This parameter is 
meaningful only when altering files routed to or changed to local batch. 
The NID entry is cleared if previously specified; that is, specifying two 
identical NED entries is the same as not specifying any at all. Default 
is no change in file identifier. 

The 3-character logical identifier specifying the new logical identifier 
associated with selected files. NLD=0 will remove the LID from 
selected files. A subsequent NLD entry replaces any NLD entry 
previously made. Default is no change in logical identifier. 

The 1- to 5-character suffix for the name of the direct access permanent 
file on which DFTERM writes the terminated dayfile. DFTERM adds a 
2-character prefix indicating the type of dayfile being terminated (AC, 
DF, ML, or ER). If NM is not specified or the specified name is a 
duplicate, DFTERM automatically assigns a name for the file as follows: 

• The first two characters indicate the type of dayfile being 
terminated (AC, DF, ML, or ER). 

• The third character is a sequence number (A through 9). 

• The next two characters indicate the month. 

• The last two characters indicate the day of the month. 

The 1- to 4-digit number (0 through 7777 8 ) specifying the new queue 
priority associated with selected output files. The NPR entry is cleared 
if previously specified; that is, specifying two identical NPR entries is 
the same as not specifying any at all. Default is no change in queue 
priority. 

The 1- or 2-digit number (0 through 77 8 ) specifying the new repeat 
count associated with selected output files. The NRC entry is cleared if 
previously specified; that is, spetifying two identical NRC entries is the 
same as not specifying any at all. Default is no change in repeat count. 

New destination user name associated with selected output files. This 
parameter is meaningful only when altering any files routed to or 
changed to remote batch. The NUN entry is cleared if previously 
specified; that is, specifying two identical NUN entries is the same as 
not specifying any at all. Default is no change in destination user name. 
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Parameter Description 



OP=opt Processing option specifying the function to be performed by each 

utility. 

With QREC, opt can be any of the following. Default is OP=RI. 

opt Description 

DI Selected active queued files are made inactive and the 
remaining active queued files are ignored. 

PI Selected inactive queued files are purged, and the remaining 
inactive queued files are ignored. 

RI Selected inactive queued files are activated (requeued), and the 
remaining inactive queued files are ignored. 

RP Selected inactive queued files are activated (requeued), and the 
remaining inactive queued files are purged. 

With QALTER, opt specifies the destination to which the selected 
queued files should be changed; it can be one of the following. Default 
is OP=NC. 

opt Description 

BC Change to local batch. 

NC Do not change file destination. 

PR Purge files. 

RB Change to remote batch. 

With DFTERM, opt specifies whether active or inactive dayfiles will be 
terminated. With QLOAD and QMOVE, opt specifies whether the 
loaded or moved queued files will be active or inactive. With these 
utilities, opt can be one of the following. Default is OP=A 

opt Description 

A Active queued files/dayfiles are specified. 

I Inactive queued files/dayfiles are specified. 
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Parameter Description 



PO=opt Processing option specifying the function to be performed. 



opt Description 



E Errored file processing status is toggled. Default conditions for 

queued file utilities include: 

QDUMP Dump file. 

QLOAD Do not load file. 

QMOVE Do not move file. 

F Entries are made in FOT for inactive families and the files are 

queued. 

I Activate inactive input queued files when the owner family is 

not active. 
L Entries are made in the LID table for inactive LIDs and the 

files are queued. 

N Only command directives are processed. The K display is 

available to monitor utility progress, but no K-display input is 
allowed. The N option is implied on all nonsystem origin jobs. 

R The dump or load file is rewound before processing begins. 

U Unconditionally dump, load, recover, or move files (the only 

restrictions are device security access limits). 
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Parameter Description 



RB=dt Queued files destined for remote batch devices can be selected for 

processing by disposition type (dt). 

dt Description 

ALL Files of all disposition types. 

IN Input files. 

LR 580-12 printer files. 

LS 580-16 printer files. 

LT 580-20 printer files. 

LX 5870 printer files. 

LY 5970 printer files. 

NONE No files. 

PH,PU Punch files. 

PL Plot files. 

PR Files that can print on any printer. 

PRINT All printer files. 

P2 512 printer files. 

SF Installation-defined special files; cannot be used with 
QALTER or QFTLIST. 

WT Queued files with a wait disposition. 

The RB entry can be specified more than once, with each successive 
entry reversing the previously established condition. By default, all 
disposition types are selected; so any entry actually clears the 
automatic selection. For example, RB=PU means remote batch-destined 
punch files are not to be processed. However, a second RB=PU entry 
reenables processing of remote batch-destined punch files. 

If RB=ALL or RB=NONE is specified, processing of all disposition types 
is either enabled or disabled, respectively. If all disposition types are 
currently enabled, entering RB=ALL has no effect. Likewise, entering 
RB=NONE has no effect if all disposition types are disabled. 
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Parameter 



Description 



SC=n 



TF=familyname 



TP=t 



Decimal number of queued files (and hence records on the dump file) to 
be skipped before the queue selection begins. Skipping begins at the 
point on the dump file indicated by the NF parameter. This parameter 
allows a restart load to begin from the last aborted queue loaded by 
QLOAD. Default is SC=0. 

Name of family for remote batch-destined files to be selected. By using 
the TF parameter with the TUI parameter, files destined for a 
particular remote batch terminal can be selected. Local batch-destined 
files are not deselected by this parameter. Default is all families 
selected. 

Type of files to move or dump. Default is TP=ALL. 

t Description 

A Active files. 

ALL Active and inactive files. 

I Inactive files. 



TUI=userindex 



UA=level 



UI=userindex 



The 1- to 6-digit value plus a radix that specifies the destination 
terminal user index for remote batch destined output files. If one 
userindex is specified (xxxxxx), only that user index is processed. If a 
range is specified (xxxxxx-yyyyyy), all indexes in the specified range are 
processed. If TUI=0, no terminal user index is specified. Default is 
TUI=0. 

The 1- to 7-character name that specifies the upper limit of the range of 
access levels to process. If this parameter is specified, the LA 
parameter must also be specified. If neither LA nor UA is specified, the 
default is that all access levels are selected. 

User index under which queued files to be processed were created. If 
two user indexes, separated by a hyphen, are specified (for example, 
75-162), all queued files created by all users having indexes within this 
range (including the end points) are processed. Default is to process all 
queued files regardless of user index. 
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Parameter 



UJN=ujn 



Description 



UN=username 



The 1- to 7-character user job name specified on Job commands 
associated with queued files being listed or altered. Only one name can 
be specified. A subsequent UJN entry replaces any UJN entry 
previously made. This parameter in conjunction with the JSN 
parameter uniquely describes which files are to be processed. Default is 
no UJN specified. 

Destination user name within the family specified by the DF option. 
UN and DF must be specified together. The utility (QALTER or 
QFTLIST) will process files belonging to the remote terminal identified 
by these parameters. The UN entry is cleared if previously specified; 
that is, specifying two identical UN entries is the same as not 
specifying any at all. 



NOTE 



If the currently displayed value for JSN, NFC, NID, NPR, NRC, NUN, or UN is reentered, 
the value for the specified parameter is cleared. 
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File Preassignment 



When using the LDLIST, QDUMP, and QLOAD utiUties, the dump or load file must be 
preassigned. This can be done by using a LABEL or an ASSIGN command. For example, 
the following commands can be used. 

LABEL , QFILES , VSN=DMP1 , D=HY . 

or 

ASSIGN , MS , QFILES . 

If no dump file is present, QDUMP will write on a local mass storage file; LDLIST and 
QLOAD will attempt to read an empty file and terminate. 

Active and Inactive Queued Files 

A queued file can be active or inactive. All queued files are originally active upon entering a 
queue. A queued file is deactivated (made inactive) when its entry is removed from the 
queued file table (QFT) and a corresponding entry is created in the inactive queued file 
table (IQFT) on the mass storage device where the queued file resides. An inactive queued 
file is activated when the entry from the IQFT is removed and a corresponding entry is 
created in the QFT. Inactive queued files are not considered for processing (other than by 
the queued file utilities), nor do they appear on any DSD display. 

Three queued file utilities can deactivate or activate queued files (QLOAD, QMOVE, and 
QREC). QLOAD and QMOVE each transfer queued files from either tape or disk to a disk 
device. Upon completion of the transfer, the utility leaves the queued files active or inactive 
according to the parameters you have specified. QREC does not perform any file transfer 
but only adjusts table entries as described in the preceding paragraph. These three utilities 
have uses other than deactivation and activation of queued files (refer to the description of 
the appropriate utility and parameters). 

Queued files are also deactivated when they are recovered during a level deadstart. Such 
files can be activated automatically by an IPRDECK entry that invokes QREC during a 
level deadstart. Refer to section 3, Deadstart Decks, for further information on IPRDECK 
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Queued File Utility Routines 

The queued file utility routines are described next. The parameters available for each of the 
routines are listed in table 18-1. The K displays (if any) for each utility are shown and 
contain lists of applicable parameters. Output formats for each utility are also shown. 

DFLIST 

DFLIST generates a printer listing of all permanent files created by the DFTERM utility. 
DFLIST can be initiated only from the system console directly through this command: 

X. DFLIST. 

The output generated by DFLIST is the same as that produced by the LIST command 
available under the DFTERM utility (refer to figure 18-7). 

DFTERM 

DFTERM terminates an active or inactive dayfile and retains it as a direct access 
permanent file on user name SYSTEMX for later interrogation or processing. When an 
active dayfile (that is, the current system dayfile, account dayfile, error log, or binary 
maintenance log) is terminated, information in the central memory buffer for that dayfile is 
written to mass storage to be included with the permanent file, and a new active dayfile is 
started. The new dayfile can reside on the same device, or a new device can be specified. 

Terminating an inactive dayfile has no effect on the currently active dayfiles. Inactive 
dayfiles are not used by the system. Furthermore, the presence of an inactive dayfile in the 
system is possible only under unusual conditions. For example, if the system is deadstarted 
and the device that previously contained the account dayfile is turned off, a new account 
dayfile is started on another device. Two devices in the system now contain account 
dayfiles. If both devices are turned on when the system is next deadstarted, two account 
dayfiles are recovered. The most recent account dayfile is made active and is used by the 
system. The remaining account dayfile is made inactive. 

The DFTERM utility can be initiated only from the system console through a K display or 
directly through the DFTERM command. No batch or terminal input is allowed. 

When DFTERM is selected at the system console, the DFTERM K display appears on the 
left screen. This display contains a fist of all applicable options associated with DFTERM, 
their default values, and a short description of each (refer to figure 18-6). 
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A list of the permanent dayfiles is displayed on the right screen when you enter this 
command: 

K.LIST. 

When this command is processed, the right screen K display is automatically replaced with 
the DFTERM dayfile list K display (refer to figure 18-7). The information presented in this 
display is the same as that generated by the DFLIST utility. 

If there are more files than can be displayed on one screen, a message appears at the 
bottom of the screen indicating that more files exist. When the LIST command is entered, a 
complete list of permanent dayfiles is written to the output file specified by the DFTERM L 
parameter; thus, a complete printer listing is provided when the DFTERM utility is 
terminated. If it is necessary to obtain the output listing immediately, enter this command: 

K.OUT. 

When this command is processed, the initial right screen K display (a list of the queued file 
utility commands) is automatically returned. However, if the OUT command is not entered, 
the original right screen K display can be returned by entering the CLEAR command. 

After DFTERM processing is completed, an output file indicating the results of this 
processing is generated if the LIST command has been entered at any time during 
DFTERM operations. (Refer to figure 18-7, which shows essentially the same format.) If the 
LIST command was not entered, no output file is generated. 



K. DFTERM. 
hh.mm.ss. yy/mm/dd. 



CDC NETWORK OPERATING SYSTEM 
MID=AA NOS version 



DFTERM 



ACTIVE DAYFILES 

TYPE FAMILY DN 

DAYFILE SYST06 2B 

ACCOUNT SYST06 2B 

ERRLOG SYST06 2B 

MAINLOG SYST06 2B 



— INACTIVE DAYFILES— 
TYPE FAMILY DN 



OPTION 



DESCRIPTION 



FT 



DAYFILE 



FM = SYST06 
DN = 2B 
OP = A 
NM = DAYF 

L = OUTPUT 



FILE TYPE TO BE TERMINATED 
(DAYFILE, ACCOUNT, ERRLOG, MAINLOG) . 

FAMILY NAME OF NEW DEVICE (1-7 CHARACTERS) . 

DEVICE NUMBER OF NEW DEVICE (0-77B) . 

OPTION (A=ACTIVE or I=INACTIVE) . 

PERMANENT FILE NAME OVERRIDES AUTOMATIC NAMING 
(1-5 CHARACTERS) . 

OUTPUT FILE (1-7 CHARACTERS) . 



Figure 18-6. DFTERM K Display (Left Screen) 
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K. DFTERM. 




jsn 












PERMANENT DAYFILE CATALOG 






CATALOG OF PERMANENT 


DAYFILES (377777). 85/01/16 09 


25.43 


NUM 


TYPE 


FM/PN 


DN 


PFNAME 


DATE 


TIME LENGTH 


1 


DAYFILE 


SYST06 


02 


DFA0116 


85/01/16 


08.00.04 


20 


2 


DAYFILE 


SYST06 


02 


DFB0116 


85/01/16 


08.00.34 


1 


3 


DAYFILE 


SYST06 


02 


DFC0116 


85/01/16 


08.01.14 


1 


4 


DAYFILE 


SYST06 


02 


DFD0116 


85/01/16 


08.01.54 


1 


5 


DAYFILE 


SYST06 


02 


DFE0116 


85/01/16 


08.02.33 


1 


6 


DAYFILE 


SYST06 


02 


DFF0116 


85/01/16 


08.03.13 


1 


7 


DAYFILE 


SYST06 


02 


DFG0116 


85/01/16 


08.03.53 


1 


8 


DAYFILE 


SYST06 


02 


DFH0116 


85/01/16 


08.04.33 


1 


9 


DAYFILE 


SYST06 


02 


DFI0116 


85/01/16 


08.05.12 


1 


10 


DAYFILE 


SYST06 


02 


DFJ0116 


85/01/16 


08.05.52 


1 


11 


DAYFILE 


SYST06 


02 


DFK0116 


85/01/16 


08.06.45 


1 


12 


DAYFILE 


SYST06 


02 


DFL0116 


85/01/16 


08.07.34 


1 


13 


DAYFILE 


SYST06 


02 


DFM0116 


85/01/16 


08.08.13 


1 


14 


DAYFILE 


SYST06 


02 


DFN0116 


08/01/16 


08.08.30 


1 






MORE PERMANENT DAYFILES. 










ENTER * 


OUT 


" FOR A FULL LIST 







Figure 18-7. DFTERM Dayfile List (Right Screen) 
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LDLIST 

LDLIST generates a printer listing of queued files present on a QDUMP dump tape. 

Since LDLIST requires a QDUMP dump tape to be preassigned, it should be entered from 
DIS or in a batch or terminal job in the form 

LDLIST, opt 1 =val 1 ,opt 2 =val 2 , . . . ,opt n =val n - 

optj=valj are parameters available for LDLIST. 

The output generated by LDLIST is the same as that produced by QLOAD (refer to figure 
18-22). 

QALTER 

QALTER displays, lists, and/or alters routing and other information about active queued 
files. The utility selects files for processing according to criteria you specify. QALTER 
purges selected files from the system when you specify OP=PR. 

You may alter the following information associated with the selected files. 

File destination. 

Access level (requires security administrator privileges). 

Print file disposition type (device code). 

External characteristics. 

Destination LID. 

Destination family (remote batch-destined files). 

Destination user name (remote batch-destined files). 

File identifier (local batch-destined files). 

Forms code. 

Priority of a queued file. 

Repeat count. 

Disposition type. 
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When QALTER is selected at the system console, the QALTER/QFTLIST K display (3 
pages) appears on the left screen. This display contains a list of all applicable parameters 
associated with QALTER, their default values, and a short description of each (refer to 
figures 18-8 through 18-10). Follow this procedure to alter active queued files: 

1. Enter the selection criteria specifying which files are to be altered (parameters FM, DN, 
DF, UN, ID, FC, UJN, LD, LA, UA, BC, RB, and JSN). 

2. Ensure that the desired files are selected by inspecting the fist of files produced by the 
K-display commands LIST or OUT (refer to figures 18-11 through 18-13). If the file 
produced by OUT is to be other than OUTPUT or contain a detailed listing of the 
selected files, specify such with the L and/or LO parameters before entering KOUT. 

3. Enter the new information to be associated with the selected files (parameters OP, 
NAL, NDC, NEC, NLD, NDF, NUN, NID, NFC, NPR, and NRC). QALTER changes 
only information specified via parameter entry. 

4. Enter K.GO. QALTER makes the requested changes, issues the message *QALTER 
COMPLETE.*, and resets the K-display parameters to their default values. 

5. Repeat steps 1 through 4 to alter additional files, or enter K.STOP. to terminate 
QALTER activity. After QALTER activity has completed, an output file is generated 
indicating the changes made to the queued files (see figure 18-13). 

Example: 

Use the QALTER utility to divert output files from the local printers to a remote terminal. 
The following command alters the routing of all batch output files with a forms code of AD. 
These files are routed to a remote terminal with family name FAM1 and user name 
USRNAM. The BC and RB parameters explicitly disable input file selection. 

QALTER, PO=N, BC=IN, RB=IN, FC=AD, OP=RB , NDF=FAM1 , NUN=USERNAM. 

The QFTLIST utility can be used in conjunction with QALTER to ensure that the files were 
properly altered. The following command generates a list of all active queued files belonging 
to the remote terminal with family name FAM1 and user name USRNAM. 

QFTLIST , PO=N, LO=F , DF=FAM1 , UK=USRNAM, BC=NONE . 
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K. QALTER. 


jsn 


hh.mm 


.ss. yy/mm/dd. CDC NETWORK OPERATING SYSTEM 






MID=AA NOS version 


QALTER 




PAGE 1 OF 3 


OPTION 


DESCRIPTION 


FM = 


ALL 


FAMILY FOR DEVICES (1-7 CHARACTERS) . 


DN = 


ALL 


DEVICE NUMBER (0-77B, *ALL*) . 


DF = 


SYS06 


DESTINATION FAMILY (1-7 CHARACTERS) . 


UN = 


DEST01 


DESTINATION USER (1-7 CHARACTERS) . 


L = 


OUTPUT 


FILE TO RECEIVE OUTPUT (1-7 CHARACTERS) . 


LO = 


S 


LIST OPTION (S=SHORT, F=FULL) . 


ID = 


OB 
67B 


ID RANGE OF FILES TO PROCESS (0-67B) . 


FC = 


11/22/33 


FORMS CODE (2 CHARACTERS OR **) . 


U JN = 


JOB02 


USER JOB NAME (1-7 CHARACTERS) . 


LD = 


MO 6 


DESTINATION LID (3 CHARACTERS) . 


LA = 


LVL2 


LOWER SECURITY ACCESS LEVEL (1-7 CHARACTERS) . 


UA = 


LVL6 


UPPER SECURITY ACCESS LEVEL (1-7 CHARACTERS) . 



Figure 18-8. QALTER/QFTLIST K Display (Left Screen) (Page 1 of 3) 



QALTER 

OPTION 



PAGE 2 OF 3 



DESCRIPTION 



BC 
RB 



(DT) 
(DT) 



JSN 



AAAA 
AAAB 
AAAC 



DISPOSITION TYPE FOR LOCAL BATCH DEVICES. 
DISPOSITION TYPE FOR REMOTE BATCH DEVICES. 

SIPPPPLLLLLW 

FNULR2RSTXYT 
BC ****-------* 

p-p **_*** — ***** 

* = OPTION SELECTED. 

OPTION WILL BE CLEARED IF PREVIOUSLY SELECTED. 

JOB SEQUENCE NAME (1-4 CHARACTERS) . 

JSN WILL BE CLEARED IF PREVIOUSLY ENTERED. 



Figure 18-9. QALTER/QFTLIST K Display (Left Screen) (Page 2 of 3) 
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QALTER 




PAGE 3 OF 3 2 


OPTION 


OP 


= 


NC 


OPTION <BC, RB, NC, PR) . 




NAL 


= 


LVL3 


NEW 


ACCESS LEVEL (1-7 CHARACTERS). 




NEC 


= 


NONE 


NEW 


DEVICE CODE (2 CHARACTERS OR NONE) . 




NEC 


= 


A9 


NEW 


EXTERNAL CHARACTERISTICS (2 CHARACTERS) . 




NLD 


= 


MO 6 


NEW 


DESTINATION LID (3 CHARACTERS) . 




NDF 


= 


SYST06 


NEW 


DESTINATION FAMILY (1-7 CHARACTERS) . 




NUN 


= 


SYSTEM 


NEW 


DESTINATION USER (1-7 CHARACTERS). 




NID 


= 


67B 


NEW 


FILE IDENTIFIER (0-67B). 




NFC 


= 


** 


NEW 


FORMS CODE (2 CHARACTERS OR **). 




NPR 


= 


7777B 


NEW 


PRIORITY FOR OUTPUT (0-7760B). 




NRC 


= 


30D 


NEW 


REPEAT COUNT (0-31D). 





Figure 18-10. QALTER/QPTLIST K Display (Left Screen) (Page 3 of 3) 



2. Page 3 of 3 of this K display is present for QALTER, but not QFTLIST. 
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ORD 

1 

2 

3 

4 

5 

6 

7 

10 

11 

12 

13 

16 

17 

20 



ACTIVE QUEUE FILE LIST 
JSNS DT LID FAMILY USERNAM TUI/ID FC 



EC LENGTH 



SYST01 
SYST01 



AAAOS PL 

AAAPB LS 

AAAQR LP 

AAARB LS 

AAASB LS 

AAATR LP 

AAAUR LP 

AAAVB LP 

AAAWR LP 

AAAXB LS M01 

AAAYR LP SYST01 

AABBR LP LBK SYST01 

AABCB LS 

AABDB LS 



SYST01 ABC1234 



ABC1234 
ABC1234 



55 

22 
1234 AX 

22 

22 
1234 AX 
1234 AX 

55 



SYST01 ABC1234 



ABC1234 
ABC1234 



1234 

22 

1234 

1234 

22 

22 



AX 

AX 
AX 



T6 
A9 
LP 
A9 
A9 
LP 
LP 
LP 
LP 
A9 
LP 
LP 
A9 
A9 



4 

6 

41 

5 

4 

41 

41 

7 

41 

5 

41 

41 

3 

2 



END OF DISPLAY. 



Figure 18-11. QALTER/QFTLIST LIST Command Display (Right Screen) 



ACTIVE QUEUE LIST 
JSN = AAAD ORDINAL = 7 

SERVICE = SYSTEM QUEUE = PRINT 



DESTINATION 

FAMILY = 

LID = M01 
USER = 
TUI/ID = 
FORMS = AX 
DISPOSITION CODE = LP 
EXTERNAL CHAR. = LP 
INTERNAL CHAR. = DIS 



CREATION 

FAMILY = SYST03 
LID = M03 
USER = 
USER INDEX = 
USER JOBNAME = DIS 

DATE = 85/01/16 
LENGTH = 2 
REPEAT = 



RESIDENCE 



FAMILY = SYST01 
DEVICE = 2 
ACCESS LEVEL = 



INTERRUPT = NO 
PRIORITY = 7110 



Figure 18-12. QALTER/QFTLIST LIST=qft Command Display (Right Screen) 
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OALTER - ALTER/PURGE ACTIVE QUEUED FILES. 



yy/mm/dd- hn.nmi.ss. 



PASE 



OPTION = NC 
NEW FORMS CODE = --N/A— 
NEW PRIORITY = 5103 
NEW REPEAT COUNT = --N/A-- 



NEW DESTINATION FAMILY NAME = — N/A- 

NEW DESTINATION USER NAME = --N/A- 

NEW DISPOSITION CODE = --N/A- 

NEW DESTINATION LID = --N/A- 



NEW EXTERNAL CHAR = — N/A- 
NEW FILE ID = — N/A- 
NEW ACCESS LEVEL = --N/A- 



CURRENT 

IttlltlllflKIIIIt 



DESTINATION 

(■viimiimifimnitiimmii 



JSN 

SERVICE 
QUEUE 
ORDINAL 



2. JSN 
SERVICE 

QUEUE 
ORDINAL 



3. JSN 
SERVICE 

QUEUE 
ORDINAL 



JSN 

SERVICE 
QUEUE 
ORDINAL 



5. JSN 
SERVICE 
QUEUE 
ORDINAL 



6. JSN 
SERVICE 
QUEUE 
ORDINAL 



7. JSN 
SERVICE 
QUEUE 
ORDINAL 



8. JSN 
SERVICE 

QUEUE 
ORDINAL 



AACG FAMILY 

ICLASS2 USER 

PRINT TUI/ID 

3 OLID 



AACI FAMILY 

TIMESHR USER 

PRINT TUI/ID 

5 DLID 



SYS964 FORMS 
BMS4247 DEVICE 
4247 EXT.CHR. 
INT.CHR. 



SYS964 FORMS 
BMS4247 DEVICE 
4247 EXT.CHR. 
INT.CHR. 



AACJ FAMILY = SYS964 FORMS 

REMOTE USER = BMS4247 DEVICE 

PRINT TUI/ID * 4247 EXT.CHR. 

6 DLID = INT.CHR. 



AACW FAMILY = SYS964 FORMS 

BATCH USER = 8MS4247 DEVICE 

PRINT TUI/ID = 4247 EXT.CHR. 

23 DLID » INT.CHR. 



AACY FAMILY = SYS964 FORMS 

TIMESHR USER = BMS4247 DEVICE 

PRINT TUI/ID * 4247 EXT.CHR. 

25 DLID - INT.CHR. 



AACZ FAMILY * SYS964 FORMS 

ICLASS2 USER * BMS4247 DEVICE 

PRINT TUI/ID « 4247 EXT.CHR. 

26 DLID ■ INT.CHR. 



AADB FAMILY - SYS964 FORMS 

REMOTE USER - BMS4247 DEVICE 

PRINT TUI/ID - 4247 EXT.CHR. 

30 DLID - INT.CHR. 



AADF FAMILY - SYS964 FORMS 

BATCH USER = BMS4247 DEVICE 

PRINT TUI/ID - 4247 EXT.CHR. 

34 DLID - INT.CHR. 



REATION 

tlltHIIISIlIttllllStltllltl tllllllllll VX1 



RESIDENCE 

IllZItttltl 



FAMILY 
LP USER 
LP USR INDX 
DIS SLID 



FAMILY 
LP USER 
LP USR INDX 
DIS SLID 



FAMILY 
LT USER 
LP USR INDX 
DIS SLID 



FAMILY 
LP USER 
LP USR INDX 
DIS SLID 



FAMILY 
LP USER 
LP USR INDX 
DIS SLID 



FAMILY 
LP USER 
LP USR INDX 
DIS SLID 



FAMILY 
LT USER 
LP USR INDX 
DIS SLID 



FAMILY 
LP USER 
LP USR INDX 
DIS SLID 



' SYS964 USR JOBNM* DIS FAMILY = SYST64 
= BMS4247 DATE • 83/07/07 DEVICE = 2 
= 4247 INTERRUPT* NO PRIORITY = 55 
REPEAT * LENGTH = 13 
ACCESS LV* 

' SYS964 USR JOBNM* DIS FAMILY = SYST64 
■■ BMS4247 DATE = 83/07/07 DEVICE = 2 
= 4247 INTERRUPT" NO PRIORITY = 55 
REPEAT * LENGTH = 5 
ACCESS LV* 

' SYS964 USR JOBNM= DIS FAMILY « SYST64 
■■ BMS4247 DATE = 83/07/07 DEVICE = 2 
■■■ 4247 INTERRUPT* NO PRIORITY = 56 
REPEAT = LENGTH = 15 
ACCESS LV* 

SYS964 USR JOBNM* DIS FAMILY = SYST64 
■■ BMS4247 DATE » 83/07/07 DEVICE - 2 
' AZtl INTERRUPT* YES PRIORITY = 56 

REPEAT = LENGTH = 13 
ACCESS LV* 

• SYS964 USR JOBNM* DIS FAMILY = SYST64 

BMS4247 DATE = 83/07/07 DEVICE » 2 
■■ 4247 INTERRUPT' YES PRIORITY = 56 
REPEAT = LENGTH = 5 
ACCESS LV* 

SYS964 USR JOBNM* DIS FAMILY * SYST64 
■■ BMS4247 DATE = 83/07/07 DEVICE = 2 
: 4247 INTERRUPT* YES PRIORITY = 56 
REPEAT * LENGTH = 13 
ACCESS LV= 

SYS964 USR JOBNM* DIS FAMILY = SYST64 
BMS4247 DATE = 83/07/07 DEVICE * 2 
■■ 4247 INTERRUPT* YES PRIORITY * 56 
REPEAT = LENGTH * 15 
ACCESS LV= 

SYSS64 USR JOBNM* DIS FAMILY * SYST64 
BMS4247 DATE * 83/07/07 DEVICE = 2 
4247 INTERRUPT* NO PRIORITY = 57 
REPEAT = LENGTH = 13 
ACCESS LV* 



Figure 18-13. QALTER Printer Listing/Output File 



60459300 U 



Queued/Dayfile Utilities 18-35 



Queued File Utilities 



QDUMP 



QDUMP dumps selected queued files from a single device, a family of devices, or all devices 
on the system. These queued files can be dumped to a tape or disk. When active queued 
files are dumped, the QFT is searched to obtain the proper file. When inactive queues are 
dumped, the IQFT is searched. QDUMP also provides a listing of all files dumped with 
information about each file processed. 

For a secured system, QDUMP determines the maximum range of access levels that can be 
dumped. If the LA and UA parameters have been used to select access level limits, these 
limits will be used. If no access level limits were selected, QDUMP uses the device limits 
determined by taking the lowest lower access limit and the highest upper access limit of all 
the devices to be processed. If this range of access levels is not within the system access 
level limits, QDUMP issues a diagnostic message. 

When QDUMP is selected at the system console, the initial QDUMP K display (3 pages) 
appears on the left screen. This display contains a list of all applicable options associated 
with QDUMP, their default values, and a short description of each (refer to figures 18-14 
through 18-16). 

If the FM parameter is specified, indicating dumping of queued files from a specified family 
of devices, the initial QDUMP left screen K display is replaced by the secondary QDUMP K 
display (refer to figure 18-17). This display closely resembles the initial QDUMP display but 
restricts QDUMP processing to the family of devices specified. Each device in the specified 
family containing inactive queued files is indicated. In addition, any parameter entered for 
the QDUMP utility is reflected in this display. Parameters not entered remain at default 
values. Only the first screen of the secondary QDUMP K display is shown, since the second 
and third screens have the same format as the corresponding screens of the initial QDUMP 
K display. 

After QDUMP processing has been completed and K-display interaction has been 
terminated by 

K.STOP. 

a QDUMP output file is generated, indicating all files dumped. Figure 18-18 is an example 
of this output. 
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K. QDUMP. 


jsn 


hh.mm.ss. yy/inm/dd. CDC NETWORK OPERATING SYSTEM 




MID=AA NOS version 


QDUMP 


PAGE 1 OF 3 


INACTIVE QUEUES 


RESIDE ON FOLLOWING FAMILIES. 


SYST06 


PACKV2 FEATURE 




(ERRORED FILE DUMPING SET) 


OPTION 


DESCRIPTION 


MI = 06 


MACHINE ID (1-2 CHARACTERS, *ALL* ) . 


FM = ALL 


FAMILY FOR DEVICES (1-7 CHARACTERS) . 


DN = ALL 


DEVICE NUMBER (0-77B, *ALL*) . 


DA = 85/01/11 


DUMP DATE RANGE (YYMMDD, *ALL*) . 


85/01/16 




L = OUTPUT 


FILE TO RECEIVE OUTPUT (1-7 CHARACTERS) . 


FN = QFILES 


DUMP FILE NAME (1-7 CHARACTERS) . 


NF = OD 


NUMBER OF MEDIA FILES TO SKIP. 


TP = ALL 


TYPE (A=ACTIVE, I=INACTIVE, *ALL* ) . 



Figure 18-14. Initial QDUMP K Display (Left Screen) (Page 1 of 3) 



QDUMP 




OPTION 


FU = 


ALL 


UI = 


OB 




377777B 


TF = 


ALL 


TUI = 


OB 




377777B 


FS = 


OB 




777777B 


ID = 


OB 




67B 


FC = 


ALL 


LA = 


LVL2 


UA = 


LVL6 


LD = 


M42 



PAGE 2 OF 3 



DESCRIPTION 



FAMILY FOR USER INDEX (1-7 CHARACTERS) . 
USER INDEX RANGE (0-377777B) . 

FAMILY FOR TERMINAL (1-7 CHARACTERS) . 
DESTINATION TERMINAL UI RANGE (0-377777B). 

FILE SIZE RANGE IN PRU-S (0-777777B). 

ID RANGE OF FILES TO PROCESS (0-67B). 

FORMS CODE (2 CHARACTERS OR **) . 
LOWER SECURITY ACCESS LEVEL (1-7 CHARACTERS) . 
UPPER SECURITY ACCESS LEVEL (1-7 CHARACTERS). 
DESTINATION LID (3 CHARACTERS). 



Figure 18-15. Initial QDUMP K Display (Left Screen) (Page 2 of 3) 
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QDUMP 




PAGE 3 OF 3 


OPTION 




DESCRIPTION 


BC = (DT) 


DISPOSITION 


TYPE FOR LOCAL BATCH DEVICES. 


RB = (DT) 


DISPOSITION 


TYPE FOR REMOTE BATCH DEVICES. 




S I P P 


PPLLLLLW 




F N U L 


R2RSTXYT 




gC * * * * 


* 




RB * * - * 


**_***** 




* = OPTION SELECTED. 




OPTION WILL 


BE CLEARED IF PREVIOUSLY SELECTED. 


JSN = AAAA 


JOB SEQUENCE NAME {1-4 CHARACTERS). 


AAAB 


JSN WILL BE 


CLEARED IF PREVIOUSLY ENTERED. 



Figure 18-16. Initial QDUMP K Display (Left Screen) (Page 3 of 3) 



K. QDUMP. jsn 

hh.mm.ss. yy/mm/dd. CDC NETWORK OPERATING SYSTEM 

MID=AA NOS version 

QDUMP PAGE 1 OF 3 

INACTIVE QUEUES RESIDE ON FOLLOWING DEVICES IN FAMILY - FEATURE 
40 

(ERRORED FILE DUMPING SET) 

OPTION DESCRIPTION 

MI = 06 MACHINE ID (1-2 CHARACTERS, *ALL*). 

FM = ALL FAMILY FOR DEVICES (1-7 CHARACTERS) . 

DN = 40B DEVICE NUMBER (0-77B, *ALL*). 

DA = 85/01/11 DUMP DATE RANGE (YYMMDD, *ALL* ) . 
85/01/16 

L = OUTPUT FILE TO RECEIVE OUTPUT (1-7 CHARACTERS) . 

FN = QFILES DUMP FILE NAME (1-7 CHARACTERS) . 

NF = OD NUMBER OF MEDIA FILES TO SKIP. 

TP = ALL TYPE (A=ACTIVE, I=INACTIVE, *ALL* ) . 



Figure 18-17. Secondary QDUMP K Display (Left Screen) 
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QDUMP 


PROCESSOR 








yy/mm/dd. hh.mm.ss. 


PAGE 


1 








• * * 


DUMPED 


QUEUE FILE DISPOSITION *** 




















LENGTH 


ACCESS 




NO. 


JSNS 


MID 


FAMILY 


DN 


DT 


DS 


DATE 


(PRUS) 


LEVEL 


DISPOSITION ERRORS 


1. 


AABAB 


64 


SYST64 


2 


PR 


BC 


83/07/07. 


1 




ACTIVE 


2. 


AABBB 


64 


SYST64 


2 


LS 


BC 


83/07/07. 


12 




ACTIVE 


3. 


AABDB 


64 


SYST64 


2 


LT 


BC 


83/07/07. 


13 




ACTIVE 


4. 


AABGT 


64 


SYST64 


2 


LT 


BC 


83/07/07. 


14 




ACTIVE 


5. 


AABJS 


64 


SYST64 


2 


PR 


BC 


83/07/07. 


15 




ACTIVE 


6. 


AABOB 


64 


SYST64 


2 


PR 


BC 


83/07/07. 


17 




ACTIVE 


7. 


AABCB 


64 


SYST64 


3 


PR 


RB 


83/07/07. 


13 




ACTIVE 


8. 


AABE2 


64 


SYST64 


3 


PR 


RB 


83/07/07. 


13 




ACTIVE 


9. 


AABFT 


64 


SYST64 


3 


PR 


RB 


83/07/07. 


5 




ACTIVE 


10. 


AABHR 


64 


SYST64 


3 


LT 


RB 


83/07/07. 


15 




ACTIVE 


11. 


AABIS 


64 


SYST64 


3 


LT 


BC 


83/07/07. 


1 




ACTIVE 


12. 


AABK2 


64 


SYST64 


3 


LT 


BC 


83/07/07. 


1 




ACTIVE 


13. 


AABLB 


64 


SYST64 


3 


PR 


BC 


83/07/07. 


1 




ACTIVE 


14. 


AABPB 


64 


SYST64 


3 


PR 


BC 


83/07/07. 


20 




ACTIVE 



Figure 18-18. QDUMP Output File 

QDUMP does not purge files upon completion. If you want to purge files, the following 
sequence of commands is recommended. 



Command 



Description 



QREC,OP=DI. 
QDUMP,TP=I. 

QREC,OP=PI. 



Dequeues the files. 

Dumps the inactive files. The dump file (default name = QFILES) 
should be preassigned before issuing this command. 

Purges the files. 
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QFTLIST 



QFTLIST displays and/or lists routing and other information about active queued files. Its 
operation is similar to that of QALTER, except file alteration or purging is not allowed. 
When QFTLIST is selected at the system console, the QFTLIST K display appears on the 
left screen. This display contains a list of all applicable parameters associated with 
QFTLIST, their default values, and a short description of each (refer to figures 18-8 through 
18-10). The output generated by QFTLIST LIST and OUT K-display commands (both 
printed and right screen K display) is similar or identical to that produced by QALTER. 

Example 1: 

Use the QFTLIST utility to determine what actions are necessary to get queued files 
processed by the RBF or BIO Subsystems. The following QFTLIST entry generates a 
detailed list of queued files, from which forms code, id, and other destination routing 
information can be determined. This information indicates what action must be taken to 
have the files processed. 

X . QFTLIST ( PO=N , LO=F ) 

Example 2: 

Use the QFTLIST utility to determine what queued files are routed to a particular device. 
The following QFTLIST entry generates a list of all print files with forms code of AA that 
are routed to a 580-20 (LT) printer. Input file selection is explicitly disabled. 

X . QFTLIST ( PO=N , FC=AA , RB= IN , BC=NONE , BC=LT ) 

QLIST 

QUEST lists inactive queued files, which may include all inactive queued files in the system 
or a selected subset based on parameters specified when the utility is called. 

The QLIST utility is not restricted to use from the system console. However, from the 
system console, QLIST must be called directly with the following command. No K-display 
interaction is available. 

X.QLIST(opt 1 =val 1 ,opt 2 =val 2 , . . . ,opt n =val n ) 

The applicable parameters associated with QLIST are the same as those used with the 
QREC utility, except for the OP parameter. The OP parameter is not valid with QLIST. 

If all current inactive queued files are to be listed, no parameters need be specified. In this 
case, the format of the QLIST call is: 

X. QLIST. 

The output generated by QLIST is the same as that produced by the LIST command 
available under the QREC utility (refer to figure 18-31). 
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QLOAD 

QLOAD processes the dump files generated by QDUMP or other utilities using the same 
format. QLOAD can selectively load the queued files from these dump files. QLOAD can 
also list title contents of a dump file without loading any files. 

For secured systems, the access level for each file selected to be loaded must be within the 
file's origin type limits and the file must be assigned to an appropriate mass storage device. 
If a selected file cannot be loaded, QLOAD issues a diagnostic message and skips that file. 

When QLOAD is selected at the system console, the QLOAD K display (3 pages) appears on 
the left screen. This display contains a list of all applicable parameters associated with 
QLOAD, their default values, and a short description of each (refer to figures 18-19 through 
18-21). 

After QLOAD processing has been completed and K-display interaction has been terminated 
by 

K.STOP. 

a QLOAD output file is generated, indicating all queued files which were contained on the 
dump file, and whether they were loaded or not. Figure 18-22 contains an example of this 
output. 

Example: 

Use the QDUMP and QLOAD utilities to dump queued files from one machine and load 
them onto another. The following commands dump all punch files from machine AA. The 
QREC utility is used to dequeue the files and then purge them, because QDUMP does not 
purge files. 

QREC , PO=N, I=DIRCTVS , OP=DI . 

REWIND, DIRCTVS. 

LABEL , QFILES , VSN=QUEUE , MT . 

QDUMP, PO=N, I=DIRCTVS, TP=I . 

REWIND, DIRCTVS . 

QREC , PO=N, OP=PI , I=DIRCTVS . 

File DIRCTVS is the input directive file that contains the following directives. 

BC=NONE,BC=PH. 
RB=NONE,RB=PH. 

The following commands load the files dumped by the previous QDUMP onto another 
machine. 

LABEL , QFILES , VSN=QUEUE , MT . 
QLOAD, PO=N, MI =AA,OP=A, DF=ALL. 
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K. QLOAD. jsn 

hh.inm.ss. yy/inm/dd. CDC NETWORK OPERATING SYSTEM 
MID=AA NOS version 



QLOAD 



PAGE 1 OF 3 





OPTION 


MI 


= 06 


DF 


= ALL 


DD 


= ALL 


DA 


= 85/01/11 




85/01/16 


L = 


= OUTPUT 


FN 


= QFILES 


NF 


= OD 


SC 


= OD 


OP 


= A 



(ERRORED FILE DUMPING SET) 

DESCRIPTION 

MACHINE ID (1-2 CHARACTERS, *ALL* ) . 
DESTINATION FAMILY (1-7 CHARACTERS) 
DESTINATION DEVICE (0-77B, *ALL* ) . 
LOAD DATE RANGE (YYMMDD, *ALL* ) . 



FILE TO RECEIVE OUTPUT (1-7 CHARACTERS) 
LOAD FILE NAME (1-7 CHARACTERS) . 
NUMBER OF MEDIA FILES TO SKIP. 
NUMBER OF QUEUED FILES TO SKIP. 
LOAD OPTION ( A=LOAD/ACTIVATE , 
I =LOAD/ INACTIVATE) . 



Figure 18-19. QLOAD K Display (Left Screen) (Page 1 of 3) 



QLOAD 




OPTION 


FU = 


ALL 


UI = 


OB 




377777B 


TF = 


ALL 


TUI = 


OB 




377777B 


FS = 


OB 




777777B 


ID = 


OB 




67B 


FC = 


ALL 


LA = 


LVL2 


UA = 


LVL6 


LD = 


M42 



PAGE 2 OF 3 



DESCRIPTION 



FAMILY FOR USER INDEX (1-7 CHARACTERS). 
USER INDEX RANGE (0-377777B) . 

FAMILY FOR TERMINAL (1-7 CHARACTERS). 
DESTINATION TERMINAL UI RANGE (0-377777B). 

FILE SIZE RANGE IN PRU-S (0-777777B) . 

ID RANGE OF FILES TO PROCESS (0-67B). 

FORMS CODE (2 CHARACTERS OR **) . 
LOWER SECURITY ACCESS LEVEL (1-7 CHARACTERS). 
UPPER SECURITY ACCESS LEVEL (1-7 CHARACTERS). 
DESTINATION LID (3 CHARACTERS) . 



Figure 18-20. QLOAD K Display (Left Screen) (Page 2 of 3) 
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QLOAD 

OPTION 



PAGE 3 OF 3 



DESCRIPTION 



BC 
RB 



(DT) 
(DT) 



JSN = AAAA 
AAAB 



DISPOSITION TYPE FOR LOCAL BATCH DEVICES. 
DISPOSITION TYPE FOR REMOTE BATCH DEVICES. 

SIPPPPLLLLLW 
FNULR2RSTXYT 

•QQ ****______ — * 

I3g **_•**_***** 

* = OPTION SELECTED. 

OPTION WILL BE CLEARED IF PREVIOUSLY SELECTED. 

JOB SEQUENCE NAME (1-4 CHARACTERS) . 

JSN WILL BE CLEARED IF PREVIOUSLY ENTERED. 



Figure 18-21. QLOAD K Display (Left Screen) (Page 3 of 3) 



QLOAD/LDLIST 


PROCESSOR. 




yy/mm/dd. hh.mm.ss 


. 


PAGE 1 . 


















LENGTH ACCESS 




NO. 


JSNS 


MID 


FAMILY 


DN 


DT 


DS 


DATE 


(PRUS) LEVEL 


DISPOSITION ERRORS 


1. 


AABAB 


64 


SYST64 


3 


PR 


BC 


83/07/07. 




1 


ACTIVE 


2. 


AABBB 


64 


SYST64 


2 


LS 


BC 


83/07/07. 




12 


ACTIVE 


3. 


AABDB 


64 


SYST64 


3 


LT 


BC 


83/07/07. 




13 


ACTIVE 


4. 


AABGT 


64 


SYST64 


2 


LT 


BC 


83/07/07. 




14 


ACTIVE 


5. 


AABJS 


64 


SYST64 


3 


PR 


BC 


83/07/07. 




15 


ACTIVE 


6. 


AABOB 


64 


SYST64 


2 


PR 


BC 


83/07/07. 




17 


ACTIVE 


7. 


AABCB 


64 


SYST64 


3 


PR 


RB 


83/07/07. 




13 


ACTIVE 


8. 


AABE2 


64 


SYST64 


2 


PR 


RB 


83/07/07. 




13 


ACTIVE 


9. 


AABFT 


64 


SYST64 


3 


PR 


RB 


83/07/07. 




5 


ACTIVE 


10. 


AABHR 


64 


SYST64 


2 


LT 


RB 


83/07/07. 




15 


ACTIVE 


11. 


AABIS 


64 


SYST64 


3 


LT 


BC 


83/07/07. 




1 


ACTIVE 


12. 


AABK2 


64 


SYST64 


2 


LT 


BC 


83/07/07. 




1 


ACTIVE 


13. 


AABLB 


64 


SYST64 


3 


PR 


BC 


83/07/07. 




1 


ACTIVE 


14. 


AABPB 


64 


SYST64 


2 


PR 


BC 


83/07/07. 




20 


ACTIVE 



Figure 18-22. QLOAD Output File 
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QMOVE 

QMOVE moves queued files from one disk device to another. It also produces a listing of all 
files moved with information about each file processed. 

For secured systems, the destination device for each file selected to be moved must have 
access level limits that are appropriate to accept the file. If the file is being reactivated as 
well as moved, its access level must be within the file's origin type limits. If a selected file 
cannot be moved, QMOVE issues a diagnostic message and skips that file. 

When QMOVE is selected at the system console, the initial QMOVE K display (3 pages) 
appears on the left screen. This display contains a list of all applicable parameters 
associated with QMOVE, their default values, and a short description of each (refer to 
figures 18-23 through 18-25). 

If the FM parameter is specified, indicating the loading of queued files to a specified family 
of devices, the initial QMOVE left screen K display is replaced by the secondary QMOVE K 
display (refer to figure 18-26). This display closely resembles the initial QMOVE display but 
restricts QMOVE processing to the family of devices specified. Each device in the specified 
family containing inactive queued files is indicated. In addition, any parameter entered for 
the QMOVE utility is reflected in this display. Parameters not entered remain at default 
values. Only the first screen of the secondary QMOVE K display is shown, since the second 
and third screens have the same format as the corresponding screens of the initial QMOVE 
K display. 

After QMOVE processing has been completed and K-display interaction has been 
terminated by 

K.STOP. 

a QMOVE output file is generated, indicating all files moved. Figure 18-27 contains an 
example of this output. 
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Example 1: 

If there are inactive queued files residing on a removable device, you can activate these files 
but must first move them to a nonremovable device. This example shows how to use the 
QMOVE utility to move queued files from the removable device with family name SYSTEM 
and device number 45 to the nonremovable device with family name FAM1 and device 
number 5. The following entries are made from DSD. 

x . QFSP . jsn is the job sequence name of QFSP. 

K, jsn. 

K. QMOVE. 

K . FM=SYSTEM, DN=45 . 

K . DF=FAM1 , DD=5 . The moved files are active. 

K.OP=A. 
K. GO, STOP. 

Example 2: 

This example exhibits the relationships among the ID, TF/TUI, and FC parameters. (Refer 
to the descriptions of these parameters for the types of files affected by them.) The following 
command moves all local batch-destined output files with ID=6 and all remote 
batch-destined output files to device 3 in family SYS. The BC and RB parameters explicitly 
disable input file processing. 

QMOVE , PO=N, DF=SYS , DD=3 , ID=6 , BC=IN, RB=IK. 

The following command performs the same function as the previous command except that 
no remote batch files are moved. 

QMOVE, PO=N, DF=SYS, DD=3 , ID=6 ,BC=IN, RB=NONE . 
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K . QMOVE . J sn 

hh.mm.ss. yy/mm/dd. CDC HETWORK OPERATING SYSTEM 
MID=AA NOS version 

QMOVE 



PAGE 1 OF 3 



INACTIVE QUEUES RESIDE ON FOLLOWING FAMILIES. 
SYST06 PACKV2 FEATURE 

(ERRORED FILE MOVING NOT SET) 



OPTION 

MI = 06 
FM = ALL 
DN = ALL 
DF = FEATURE 
DD = 40B 

DA = 85/01/11 
85/01/16 
L = OUTPUT 
TP = ALL 
OP = A 



DESCRIPTION 

MACHINE ID (1-2 CHARACTERS, *ALL*) . 
FAMILY FOR DEVICES (1-7 CHARACTERS). 
DEVICE NUMBER (0-77B, *ALL* ) . 
DESTINATION FAMILY (1-7 CHARACTERS). 
DESTINATION DEVICE (0-77B). 

DATE RANGE (YYMMDD, *ALL* ) . 

FILE TO RECEIVE OUTPUT (1-7 CHARACTERS). 
TYPE (A=ACTIVE, I=INACTIVE, *ALL*) . 
OPTION (A=LEAVE ACTIVE, I=LEAVE INACTIVE) 



Figure 18-23. Initial QMOVE K Display (Left Screen) (Page 1 of 3) 



QMOVE 




OPTION 


FU = 


ALL 


UI = 


OB 




377777B 


TF = 


ALL 


TUI = 


OB 




377777B 


FS = 


OB 




777777B 


ID = 


OB 




67B 


FC = 


ALL 


LA = 


LVL2 


UA = 


LVL6 


LD = 


M42 



PAGE 2 OF 3 



DESCRIPTION 



FAMILY FOR USER INDEX (1-7 CHARACTERS) . 
USER INDEX RANGE (0-377777B) . 

FAMILY FOR TERMINAL (1-7 CHARACTERS) . 
DESTINATION TERMINAL UI RANGE (0-377777B) . 

FILE SIZE RANGE IN PRU-S (0-777777B) . 

ID RANGE OF FILES TO PROCESS (0-67B) . 

FORMS CODE (2 CHARACTERS OR **). 
LOWER SECURITY ACCESS LEVEL (1-7 CHARACTERS) . 
UPPER SECURITY ACCESS LEVEL (1-7 CHARACTERS) . 
DESTINATION LID (3 CHARACTERS) . 



Figure 18-24. Initial QMOVE K Display (Left Screen) (Page 2 of 3) 
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QMOVE 

OPTION 



PAGE 3 OF 3 



DESCRIPTION 



BC 
RB 



(DT) 
(DT) 



DISPOSITION TYPE FOR LOCAL BATCH DEVICES. 
DISPOSITION TYPE FOR REMOTE BATCH DEVICES. 



SIPPPPLLLLLW 
FNULR2RSTXYT 



JSN 



AAAA 
AAAB 



BC 

RB 

* = OPTION SELECTED. 

OPTION WILL BE CLEARED IF PREVIOUSLY SELECTED. 

JOB SEQUENCE NAME (1-4 CHARACTERS) . 

JSN WILL BE CLEARED IF PREVIOUSLY ENTERED. 



Figure 18-25. Initial QMOVE K Display (Left Screen) (Page 3 of 3) 



K . QMOVE . 


jsn 


hh.mm.ss. yy/mm/dd. CDC NETWORK OPERATING SYSTEM 




MID=AA NOS version 


QMOVE 


PAGE 1 OF 3 


INACTIVE QUEUES 


RESIDE ON FOLLOWING DEVICES IN FAMILY - FEATURE 


40 






(ERRORED FILE MOVING NOT SET) 


OPTION 


DESCRIPTION 


MI = 06 


MACHINE ID (1-2 CHARACTERS, *ALL* ) . 


FM = FEATURE 


FAMILY FOR DEVICES (1-7 CHARACTERS). 


DN = 40B 


DEVICE NUMBER (0-77B, *ALL*) . 


DF = FEATURE 


DESTINATION FAMILY (1-7 CHARACTERS) . 


DD = 40B 


DESTINATION DEVICE (0-77B) . 


DA = 85/01/11 


DATE RANGE (YYMMDD, *ALL*). 


85/01/16 




L = OUTPUT 


FILE TO RECEIVE OUTPUT (1-7 CHARACTERS) . 


TP = ALL 


TYPE (A=ACTIVE, I=INACTIVE, *ALL* ) . 


OP = A 


OPTION (A=LEAVE ACTIVE, I=LEAVE INACTIVE) . 



Figure 18-26. Secondary QMOVE K Display (Left Screen) 
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QMOVE 


PROCESSOR 








yy/itim/dd. hh 


.ifflti. 


ss. 


PAGE 1 








* ** 


MOVED 


QUEUE FILE DISPOSITION *** 


ACTIVE FILES 


MOVED TO FAMILY SYST64 DEVICE 


2 


AND LEFT ACTIVE 


















LENGTH 


ACCESS 


NO. 


JSNS 


MID 


FAMILY 


DN 


DT 


DS 


DATE 


(PRUS) 


LEVEL DISPOSITION ERRORS 


1. 


AABCB 


64 


SYST64 


3 


PR 


RB 


83/07/07. 




13 




2. 


AABE2 


64 


SYST64 


3 


PR 


RB 


83/07/07. 




13 




3. 


AABFT 


64 


SYST64 


3 


PR 


RB 


83/07/07. 




5 




4. 


AABHR 


64 


SYST64 


3 


LT 


RB 


83/07/07. 




15 




5. 


AABIS 


64 


SYST64 


3 


LT 


BC 


83/07/07. 




1 




6. 


AABK2 


64 


SYST64 


3 


LT 


BC 


83/07/07. 




1 




7. 


AABLB 


64 


SYST64 


3 


PR 


BC 


83/07/07. 




1 




8. 


AABPB 


64 


SYST64 


3 


PR 


BC 


83/07/07. 




20 




9. 


AABQB 


64 


SYST64 


3 


PR 


BC 


83/07/07. 




2 




10. 


AABSB 


64 


SYST64 


3 


LT 


BC 


83/07/07. 




13 




11. 


AABUS 


64 


SYST64 


3 


PR 


BC 


83/07/07. 




15 




12. 


AABWB 


64 


SYST64 


3 


PR 


RB 


83/07/07. 




13 




13. 


AABYT 


64 


SYST64 


3 


PR 


RB 


83/07/07. 




5 




14. 


AACAS 


64 


SYST64 


3 


LT 


BC 


83/07/07. 




2 




15. 


AACCB 


64 


SYST64 


3 


PR 


BC 


83/07/07. 




2 





Figure 18-27. QMOVE Output File 
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QREC 

QREC deactivates or activates selected queued files and purges selected inactive queued 
files. 

For secured systems, the access level for any file selected to be reactivated must be within 
the file's origin type limits. If a selected file cannot be processed, QREC issues a diagnostic 
message and skips that file. 

When QREC is selected at the system console, the initial QREC K display (3 pages) appears 
on the left screen. This display contains a list of all applicable parameters associated with 
QREC, their default values, and a short description of each (refer to figures 18-28 through 
18-30). 

A complete list of current inactive queued files is displayed on the right screen when you 
enter this command: 

K.LIST. 

When this command is processed, the right screen K display is automatically replaced with 
the inactive queues K display (refer to figure 18-31). The information presented in this 
display is the same as that generated by the QLIST utility. The list of files displayed is also 
written to the output file specified by the QREC L parameter. 

If the FM parameter is specified, indicating processing of queued files for a specified family of 
devices, the initial QREC left screen K display is replaced by the secondary QREC K display 
(refer to figure 18-32). This display closely resembles the initial QREC display but restricts 
QREC processing to the family of devices specified. Each device in the specified family 
containing inactive queued files is indicated. In addition, any parameter entered for the 
QREC utility is reflected in this display. Parameters not entered remain at default values. 
Only the first screen of the secondary QREC K display is shown, since the second and third 
screens have the same format as the corresponding screens of the initial QREC K display. 

After QREC processing has been completed and K-display interaction has been terminated 
by 

K.STOP. 

a QREC output file is generated, indicating the disposition of all queued files processed. 
Figure 18-33 is an example of this output. 
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Example 1: 

If the QFT is becoming full, you can enter QREC from DSD to dequeue active queued files 
and free up QFT space. This QEEC entry dequeues all queued files: 

X . QREC ( OP=DI , PO=N) 

If RBF is not active, you are still able to dequeue remote batch files by using QREC. This 
QREC entry dequeues all remote batch files: 

X . QREC (OP=DI , BC=NONE , PO=N) 

If these are queued files that previously had been dequeued, you can activate these files 
with QREC. This QREC entry requeues all inactive queued files: 

X . QREC (OP=RI , PO=NU) 

Example 2: 

Purge all queued files (active and inactive) on a particular device by using QREC either 
with or without an input directive file. The first method involves two calls to QREC. The 
first QREC call dequeues (makes inactive) all active queued files on the device with family 
name SYSTEM and device number 1, and the second QREC call purges all inactive (and 
hence all) queued files on that same device. 

QREC, PO=N, OP=DI , FM=SYSTEM, DN=1 . 
QREC, PO=N, OP=PI , FM=SYSTEM, DN=1 . 

The second method involves only one command call to QREC to perform the same function 
as the first method: 

QREC,I=DIR. 

File DIR is the input directive file that contains the following directives. 

OP=DI , FM=SYSTEM, DN=1 . 

GO. 

OP=PI , FM=SYSTEM, DN=1 . 

GO, STOP. 
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Example 3: 

This example exhibits the relationships among the ID, TF/TUI, and FC parameters. It is 
important to observe the following restrictions regarding these parameters and QREC. 

• ID pertains only to local batch-destined output files. 

• TF or TUI pertains only to remote batch-destined output files. 

• FC pertains to all output files. 

• When you specify the OP parameter, all queued files are processed unless the ID, TF, 
TUI, or FC parameter restricts output file selection or the BC or RB parameter restricts 
input or output file selection. 

The following command activates all local batch-destined output files with ID=6 and FC=AD, 
all remote batch-destined files with TF=SYSTAA,TUI=3751 and FC=AD, and all input files. 

QREC , PO=N, OP=RI , ID=6 , TF=SYSTAA, TUI=3751 , FC=AD . 

The following command performs the same functions as the previous command except that 
no input files are processed. 

QREC , PO=N, OP=RI , ID=6 , TF=SYSTAA, TUI=3751 , FC=AD, BC=IN, RB=IN. 



K. QREC. 


jsn 


hh.mm.ss. yy/itim/dd. CDC NETWORK OPERATING SYSTEM 




MID=AA NOS version 


QREC 


PAGE 1 OF 3 


INACTIVE QUEUES 


RESIDE ON FOLLOWING FAMILIES. 


SYST06 


PACKV2 FEATURE 


OPTION 


DESCRIPTION 


MI = 06 


MACHINE ID (1-2 CHARACTERS, *ALL*). 


FM = ALL 


FAMILY FOR DEVICES (1-7 CHARACTERS) . 


DN = ALL 


DEVICE NUMBER (0-77B, *ALL* ) . 


DA = 85/01/11 


QUEUED DATE RANGE (YYMMDD, *ALL*). 


85/01/16 




L = OUTPUT 


FILE TO RECEIVE OUTPUT (1-7 CHARACTERS) . 


OP = RI 


PROCESS OPTION. 




DI = MAKE SELECTED ACTIVE FILES INACTIVE. 




PI = PURGE SELECTED INACTIVE FILES. 




RI = REQUEUE SELECTED INACTIVE FILES. 




RP = REQUEUE SELECTED INACTIVE FILES AND 




PURGE REMAINING INACTIVE FILES. 



Figure 18-28. Initial QREC K Display (Left Screen) (Page 1 of 3) 
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QREC 

FU = 
UI = 

TF = 
TUI 

FS = 

ID = 

FC = 
LA = 
UA = 
LD = 



PAGE 2 OF 3 



OPTION 

= ALL 
= OB 

377777B 
= ALL 

OB 

377777B 

OB 

777777B 

OB 

67B 

ALL 

LVL2 

LVL6 

M42 



DESCRIPTION 



FAMILY FOR USER INDEX (1-7 CHARACTERS). 
USER INDEX RANGE (0-377777B). 

FAMILY FOR TERMINAL (1-7 CHARACTERS) . 
DESTINATION TERMINAL UI RANGE (0-377777B) . 

FILE SIZE RANGE IN PRU-S (0-777777B) . 

ID RANGE OF FILES TO PROCESS (0-67B) . 

FORMS CODE (2 CHARACTERS OR **). 
LOWER SECURITY ACCESS LEVEL (1-7 CHARACTERS) . 
UPPER SECURITY ACCESS LEVEL (1-7 CHARACTERS) . 
DESTINATION LID (3 CHARACTERS) . 



Figure 18-29. Initial QREC K Display (Left Screen) (Page 2 of 3) 



QREC 

OPTION 



PAGE 3 OF 3 



DESCRIPTION 



BC 
KB 



(DT) 
(DT) 



DISPOSITION TYPE FOR LOCAL BATCH DEVICES. 
DISPOSITION TYPE FOR REMOTE BATCH DEVICES. 

SIPPPPLLLLLW 
FNULR2RSTXYT 



BC 
RB 



* * * * 



* * * _ 



* * * * 



JSN = AAAA 
AAAB 



* = OPTION SELECTED. 

OPTION WILL BE CLEARED IF PREVIOUSLY SELECTED. 

JOB SEQUENCE NAME (1-4 CHARACTERS) . 

JSN WILL BE CLEARED IF PREVIOUSLY ENTERED. 



Figure 18-30. Initial QREC K Display (Left Screen) (Page 3 of 3) 
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NO. 

1. 

2. 

3. 

4. 

5. 

6. 

7. 

8. 

9. 
10. 
11. 
12. 
13. 



*** INACTIVE QUEUES LIST *** 

LENGTH ACCESS 
(PRUS) LEVEL 



JSNS MID FAMILY DN DT DS 



DATE 



AABEB 
AABFR 
AABG1 
AABH2 
AABIR 
AABJ2 
AABKR 
AABLR 
AABM2 
AABN2 
AABOl 
AABPB 
AABDB 



64 SYST64 
64 SYST64 
64 SYST64 
64 SYST64 
64 SYST64 
64 SYST64 
64 SYST64 
64 SYST64 
64 SYST64 
64 SYST64 
64 SYST64 
64 SYST64 
64 SYST64 



LS BC 
PR RB 
PR RB 
LS BC 
PR RB 
PR BC 
PR RB 
PR RB 
LS BC 
LS BC 
PR RB 
LS BC 
LS BC 



83/08/08. 


5 


83/08/08. 


41 


83/08/08. 


41 


83/08/08. 


5 


83/08/08. 


41 


83/08/08. 


7 


83/08/08. 


41 


83/08/08. 


41 


83/08/08. 


4 


83/08/08. 


5 


83/08/08. 


41 


83/08/08. 


6 


83/08/08. 


2 



END OF DISPLAY. 



Figure 18-31. Inactive Queues K Display (Right Screen) 



K . QREC . j sn 

hh.mm.ss. yy/mm/dd. CDC NETWORK OPERATING SYSTEM 
MID=AA NOS version 

QREC 



PAGE 1 OF 3 



INACTIVE QUEUES RESIDE ON FOLLOWING DEVICES IN FAMILY - FEATURE 
40 



OPTION 

MI = 06 
FM = FEATURE 
DN = 40B 
DA = 85/01/11 
85/01/16 
L = OUTPUT 
OP = RI 



DESCRIPTION 

MACHINE ID (1-2 CHARACTERS, *ALL* ) . 
FAMILY FOR DEVICES (1-7 CHARACTERS). 
DEVICE NUMBER (0-77B, *ALL*) . 
QUEUED DATE RANGE (YYMMDD, *ALL* ) . 

FILE TO RECEIVE OUTPUT (1-7 CHARACTERS). 
PROCESS OPTION. 

DI = MAKE SELECTED ACTIVE FILES INACTIVE. 

PI = PURGE SELECTED INACTIVE FILES. 

RI = REQUEUE SELECTED INACTIVE FILES. 

RP = REQUEUE SELECTED INACTIVE FILES AND 
PURGE REMAINING INACTIVE FILES. 



Figure 18-32. Secondary QREC K Display (Left Screen) 
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QREC/QLIST PROCESSOR. 



NO. JSNS MID FAMILY DN DT DS DATE 

1. AABAB 64 SYST64 2 PR BC 83/07/07. 

2. AABBB 64 SYST64 2 LS BC 83/07/07. 

3. AABE2 64 SYST64 2 PR RB 83/07/07. 

4. AABDB 64 SYST64 2 LT BC 83/07/07. 

5. AABFT 64 SYST64 2 PR RB 83/07/07. 

6. AABHR 64 SYST64 2 LT RB 83/07/07. 

7. AABGT 64 SYST64 2 LT BC 83/07/07. 

8. AABIS 64 SYST64 2 LT BC 83/07/07. 

9. AABK2 64 SYST64 2 LT BC 83/07/07. 

10. AABJS 64 SYST64 2 PR BC 83/07/07. 

11. AABLB 64 SYST64 2 PR BC 83/07/07. 

12. AABPB 64 SYST64 2 PR BC 83/07/07. 

13. AABOB 64 SYST64 2 PR BC 83/07/07. 

14. AABQB 64 SYST64 2 PR BC 83/07/07. 

15. AABSB 64 SYST64 2 LT BC 83/07/07. 

16. AABRB 64 SYST64 2 LS BC 83/07/07. 

17. AABUS 64 SYST64 2 PR BC 83/07/07. 

18. AABTT 64 SYST64 2 LT BC 83/07/07. 

19. AABWB 64 SYST64 2 PR RB 83/07/07. 

20. AABVB 64 SYST64 2 PR BC 83/07/07. 

21. AABYT 64 SYST64 2 PR RB 83/07/07. 

22. AABX2 64 SYST64 2 PR RB 83/07/07. 

23. AACAS 64 SYST64 2 LT BC 83/07/07. 

24. AABZR 64 SYST64 2 LT RB 83/07/07. 

25. AACCB 64 SYST64 2 PR BC 83/07/07. 

26. AACB2 64 SYST64 2 LT BC 83/07/07. 

27. AACDB 64 SYST64 2 PR BC 83/07/07. 

28. AABCB 64 SYST64 2 PR RB 83/07/07. 



mm.ss. PAGE 


L 


riON *** 




LENGTH ACCESS 




(PRUS) LEVEL 


DISPOSITION 


1 


ACTIVATE 


12 


ACTIVATE 


13 


ACTIVATE 


13 


ACTIVATE 


5 


ACTIVATE 


15 


ACTIVATE 


14 


ACTIVATE 


1 


ACTIVATE 


1 


ACTIVATE 


15 


ACTIVATE 


1 


ACTIVATE 


20 


ACTIVATE 
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Figure 18-33. QREC Output File 
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Dayfile Dumping Utilities 

The dayfile dumping utilities (AFD, DFD, ELD, GETLOG, MAINLOG) write all or selected 
parts of the account dayfile, system dayfile, error log, or binary maintenance log to a file. 
AFD, DFD, and ELD produce a listing (output) file. GETLOG writes the error log, binary 
maintenance log, and an image of the equipment status table to files. GETLOG is used to 
provide input to the Hardware Performance Analyzer (HPA). MAINLOG produces its output 
in a binary format. A job using any of these utilities must be of system origin, or you must 
have system origin privileges and the system must be in debug mode. The following format 
is used to call the dayfile dumping utilities. 

utility,L=listfile,FR=string,OP=op,PD=pd,PL=pl,I=infile, 
B=binfile,E=estfile. 



or 



utility, listfile, string, op, pd, pi, infile,binfile,estfile. 



Parameter Description 



utility 



Utility called to perform the dayfile dump. 
Utility Description 



AFD Dump account dayfile. 

DFD Dump system dayfile. 

ELD Dump error log. 

GETLOG Dump error log, binary maintenance log, and EST image. 

MAINLOG Dump binary maintenance log. 



L=listfile Output file containing the dayfile dump produced by AFD, DFD, or ELD. 

For GETLOG, listfile is the file containing the error log. The utility also 
places diagnostic messages in this file when various error conditions occur. 
These messages begin with NOTICE*** to distinguish them from the lines 
of the dayfile being processed; they are described in the NOS Version 2 
Operations Handbook. 

The default name of listfile is OUTPUT for AFD, DFD, and ELD. The 
default name is ERR for GETLOG. If L=0 is specified, no file is written. 
L=listfile is not used with MAINLOG. The utility paginates listfile if it is 
OUTPUT or if print density and page length are specified. 
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Parameter Description 



FR=string Search string for selective dayfile dumping. The utility searches the 

dayfile for this string in the starting position of the field specified by the 
OP=op parameter. 

The string specified must begin with the first character in the field to be 
searched. The time field begins with a blank. 

If the string contains characters other than letters and numbers (such as 
blanks), it must be enclosed by $ delimiters. A $ within the string must be 
entered twice ($$) so it is not interpreted as a delimiter. Interactive 
commands entered in the dayfile are preceded by a $ unless you were 
under the batch subsystem when you issued the command. To search for 
an interactive command, the $ preceding the command is replaced with two 
$s, and the command is enclosed by $ delimiters (for example, $$$OLD$). 

If the string is found, the portion of the dayfile following the last 
occurrence of the specified string is output. If the string is not found, an 
informative message and the entire dayfile is output for jobs where the 
output file is connected to a terminal; where the output file is not 
connected to a terminal, the job receives only the informative message. 

OP=op Dump option. If neither FR=string nor the OP dump option is specified, 

default is OP=F for nonterminal output files. For terminal output files, the 
default is OP=I. If FR is specified but OP is not, default is OP=M. 

op Description __^^_ 

F Full dayfile dump is taken. 

I Incremental dump is taken. The dayfile is dumped starting from the 

point of the last dayfile dump. AFD does not process the I option 
when executed within a job with system origin privileges that is not 
system origin. 

J The job sequence name field in the dayfile is searched for the string 
specified by FR=string. The dump begins from that point. 

M The message field in the dayfile is searched for the string specified 
by FR=string. The dump begins from that point. OP=M cannot be 
used with MAINLOG. 

P Incremental dump is taken. The dayfile is dumped starting from the 
point of the last dayfile dump with this job name. 

T The time field in the dayfile is searched for the string specified by 
FR=string. The dump begins from that point. 
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Parameter Description 



PD=pd Print density in pd lines per inch (3, 4, 6, or 8). Default is PD=6. PD 

cannot be used with MAINLOG. 

PL=pl Page length in pi lines per page. Default is based on the following print 

densities. PL cannot be used with MAINLOG. 

pd Default pi 

3 30 

4 40 
6 60 
8 80 

I=infile An attached, terminated dayfile is to be used for input. For GETLOG, 

infile is an attached terminated binary maintenance log. If omitted, the 
utility uses the active dayfile for input. 

B=binfile File on which GETLOG and MAINLOG write the binary maintenance log. 

These utilities write binfile with W-type records having C-type blocking 
(refer to the CYBER Record Manager Basic Access Methods Reference 
Manual for further information on record types and record blocking). 
GETLOG and MAINLOG assume B=BML if this parameter is omitted. If 
B=0 is specified, no file is written. 

E=estfile File on which GETLOG writes an image of the equipment status table. 

GETLOG assumes E=EST if this parameter is omitted. If E=0 is specified, 
no file is written. 
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After the system is loaded, you can use the SYSEDIT command to modify the system 
library. A job containing a SYSEDIT command must either be a system origin job, or you 
must be validated for system origin privileges and the system must be in debug mode. Refer 
to the DEBUG command in section 5 for a description of debug mode. In addition, to 
prevent unauthorized modification of the operating system on a secured system, SYSEDIT 
will be allowed only from jobs with security administrator privileges. 

NOTE 

Using SYSEDIT in a production environment may cause unpredictable results and is not 
recommended. The system should be idle to ensure predictable results. 



The format of the command is: 

SYSEDIT, p 1# p 2 , . . . ,p 



directive-j^ , directive 2 , - . - , directive^ 



Pi is either a keyword or a keyword equated to a value. 
Pj Description 



B=repfile Replacement records are on file repfile. 

B Same as B=LGO. 

B=0 No replacement file. 

B omitted Same as B=LGO. 

C Checkpoint of the system follows SYSEDIT. This parameter is required if 

changes made to the system library are to be recovered during a level 3 
recovery deadstart. 

C omitted No checkpoint is performed unless the system was generated using the 

alternate system library residency feature or the PROBE utility was 
enabled. In these cases, the checkpoint automatically follows SYSEDIT. 

I=infile Directive input is on file infile. 

I Same as I=INPUT. 

1=0 No directive input. 

I omitted Same as I=INPUT. 

L=outfile list output is on file outfile. 

L Same as L=OUTPUT. 
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Pi 



NOTE 



Description 



L=0 No list output. 

L omitted Same as L=0. 

NA SYSEDIT does not abort if the system file is busy. Execution continues 

when the system file is no longer busy. 

R=n Restoration is made to copy n of the system. The system copy number is 

printed on the output listing. 

R Restoration is made to initial deadstart system. 

R=0 No system file restoration. 

R omitted Same as R=0. 

Z Directive input follows the terminator on the command. The I option is 

ignored. 

Z omitted The system uses the I option for directive input. 



If the Z option is specified, a terminator must not be placed after the input directives. 



19-2 NOS Version 2 Analysis Handbook 



60459300 U 



Directives 



Directives 

Discussed next are input directives to SYSEDIT. The directives *CM, *MS, *AD, *SC, *FL, 
and */ can be placed on LIBDECK A list of valid record types follows the directive 
descriptions. 

*CM Directive 

The *CM directive specifies the system library routines that are to reside in central memory 
resident (CMR). These routines will reside in the resident peripheral library (RPL) and 
resident central library (RCL). 

The format of the directive is: 

*CM, ty 1 /rec 1 , ty 2 /rec 2 , - - - , ty n /rec n 

Parameter Description 



ty/reCj Record type and record name of the routine. 

Central memory is the most accessible of all storage devices for PP programs. SYSEDIT 
automatically includes those programs in CMR that must reside in CMR with the exception 
of TRACER CPD overlays. If TRACER CPD is used, a *CM directive must be included for 
PP routines 3CR and 3CS. 

SYSEDIT automatically includes the following programs in CMR: 

• Mass storage drivers. 

• Programs specified in the internal tables of SLL (SYSEDIT service routine), such as 
1DD and ODF. These tables are modified at deadstart to exclude programs not required 
by the configuration. 

• Some DSD overlays, such as the 9Cx overlays. A site may make additional DSD 
overlays reside in CMR. 

In addition, it is suggested that high usage PP programs (such as 1MT, IMS, 4MA through 
4MF, and PFM) reside in CMR. However, any addition to central memory allows less space 
for user jobs. REL type records cannot reside in CMR. 

Like any other job in NOS, SYSEDIT has a field length restriction of 376000 8 central 
memory words. You cannot use more than approximately 326000 8 central memory words 
(376000 8 - 50000 8 words for SYSEDIT's program FL) when defining records to be central 
memory resident. 
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*MS Directive 

The *MS directive identifies which system library routines will reside on the system device. 
It is the default residence for routines; any routine not specified as *CM will automatically 
reside on the system device, even if *MS is not entered in the LIBDECK 

The format of the directive is: 

*MS, tyj/rec-L, ty 2 /rec 2 , . . . , ty n /rec n 

Parameter Description 



tyj/recj Record type and record name of the routine. 
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*AD Directive 

The *AD directive places copies of specific system library routines on particular mass 
storage devices so that they will be accessed from a device other than the system device. 
For example, it is advantageous to: 

• Place frequently used system library routines in extended memory for faster access 
than is possible from the system device. Notice that CPU programs residing in extended 
memory can be accessed faster than CPU programs residing in central memory. 

• Place PP routines on a mass storage device that has better latency than does the 
system device. 

Once a routine is on an alternate system device, it is accessed from that device instead of 
from the system device (*MS LIBDECK entries), except in the following cases of error 
recovery: 

• If there is an unrecoverable error for a PP routine on an alternate system device, all of 
the PP routines will subsequently be accessed from the system device instead of from 
any of the alternate system devices. 

• If there is an unrecoverable error for a CPU, ABS, or OVL routine on an alternate 
system device, only that routine will subsequently be accessed from the system device. 

• If there is an unrecoverable error for an REL CPU routine, the alternate system device 
must be turned off by the operator to prevent further access to the routine. In this case, 
the system copy will be used for backup. The alternate system device is not used for 
loads. 

The devices that are to be used as alternate system devices are specified with the ASR entry 
in the EQPDECK (refer to section 3, Deadstart Decks); the routines that are to reside on 
each alternate system device are specified in LIBDECK. 

The format of the directive is: 

*AD,xx / ty 1 /rec 1 ,ty 2 /rec 1 , . . -,ty n /rec n 

Parameter Description _^_^_ _____ 

xx The 1- or 2-digit EST ordinal or 2-character equipment type of the 

equipment to be used as an alternate system device. The equipment can 
be any nonremovable mass storage device (including extended memory) 
except for a system device. The EST ordinal specified cannot be larger 
than37 8 . 

If the equipment is not specified in the EQPDECK with the ASR entry, 
the *AD entry is ignored without an error indication when the system is 
loaded. 
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Parameter Description 



tyj Record type of routine: 

Record Type Description 



ABS CPU multiple entry point overlay. 

OVL CPU overlay. 

PP PP absolute. 

REL Relocatable CPU routine. 

jlf a record type other than ABS, OVL, PP, or REL is 
specified, the run is aborted. 

recj Record name of routine. A routine is allowed on only one alternate system 

device. 

Additional qualifications: 

• Once a routine is placed on an alternate system device, SYSEDIT may be used to 
prohibit access to the routine; however, the space for that routine is not released until 
LIBDECK is modified and the system is reloaded. 

• If extended memory is an alternate system device, all ABS, OVL, or REL routines 
residing there will be loaded from extended memory directly to the load address. 

• If DDP is available, PP programs residing in extended memory will be loaded using 
DDP, and CPU programs will be loaded using the CPU access to extended memory. 
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*SC Directive 

The *SC directive specifies the commands in a certain program that are to be processed in 
product set format rather than in NOS format (refer to the NOS Version 2 Reference Set, 
Volume 3). 

The format of the directive is: 

*SC,ty 1 /rec 1 ,ty 2 /rec 2 ,ty n /rec n 

Parameter Description 



ty/rec- Record type and record name of the routine to be processed in product set 

format. 



*FL Directive 

The * FL directive specifies the field length that routines to be loaded require to begin 
execution. 

The format of the directive is: 

*FL,ty 1 /rec 1 -fl 1 ,ty 2 /rec 2 -fl 2 ty n /rec n -fl n 

Parameter Description 



tyj/req Record type and record name of the routine. 

flj Field length divided by 100 8 required by the routine. 

The actual field length obtained is subject to the rules governing RFL= and MFL= entry 
points, since the specified flj field is placed in the library directory. The system uses this 
information to determine field length in the following manner: 

1. If bit 11 is not set, an RFL= entry point is indicated. The field length is set to the value 
in the entry. 

2. If bit 11 is set (indicating a value of 400000 8 ), an MFL= entry point is indicated. The 
field length is determined in one of two ways: 

a. If bit 10 is also set, the field length is set to the maximum of the value of the last 
RFL command and the value in the entry after masking off these upper 2 bits. 

b. If bit 10 is not set, the field length is set to the maximum of the existing field 
length and the value in the entry after masking off these upper 2 bits. 
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*/ Directive 

The */ directive specifies comment lines that are listed on the output file. Other than being 
listed on the output file, comment lines are ignored. They can occur any place in the 
directives file or on LIBDECK 

The format of the directive is: 

* / comment 

Parameter Description 

comment A comment line can contain any valid characters and be used for any 

purpose. 



*DELETE Directive 

The *DELETE directive deletes a record from the system. It cannot, however, delete a user 
library (ULIB type record). 

The format of the directive is: 

♦DELETE, tyjyrec-L, ty 2 /rec 2 , . . . ,ty n /rec n 

or 

*D, tyj/rec-L, . . . , ty n /rec n 

Parameter Description _^___ 

tyj/reci Record type and record name to be deleted from the system. ty 4 must not 

be ULIB. 
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*FILE Directive 

The *FILE directive declares an additional file containing records to be added to the system 
or to logically replace records on the system. 

The format of the directive is: 

*FILE, filename 

or 

*FILE, filename,NR 

Parameter Description 

filename Name of local file containing addition or replacement records to be placed 

on the system. File filename is rewound before processing if NR is omitted. 

NR Optional parameter that inhibits rewinding of file filename before 

processing. 



*IGNORE Directive 

The *IGNORE directive specifies that records on a replacement file are to be ignored. If no 
*FILE directive precedes an *IGNORE directive, SYSEDIT ignores the records named on 
this directive on the replacement file specified by the B parameter. If one or more *FILE 
directives precede an *IGNORE directive, SYSEDIT ignores the records on the file specified 
in the most recent *FILE directive. 

The format of the directive is: 

♦IGNORE, ty-i/rec-L , ty 2 /rec 2 , . . . , ty n /rec n 

Parameter Description 

ty/recj Record type and record name to be ignored on the current replacement file. 



*PPSYN Directive 

The *PPSYN directive specifies one or more names to be synonymous with the name of an 
existing PP routine. 

The format of the directive is: 

*PPSYN,name/name 1 ,name 2 , - . . ,name n 

Parameter Descr iption 

name Name of existing PP routine. 

namej Additional (synonymous) name for name. 
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Record Types 

The following record types may be specified in SYSEDIT directives. 

Type Description 

ABS 

CAP 

OPL 

OPLC 

OPLD 

OVL 

PP 

PPU 

PROC 

REL 

TEXT 

ULIB 



Multiple entry point overlay. 
Fast dynamic load capsule. 
Modify old program library deck. 
Modify old program library common deck. 
Modify old program library directory. 
Central processor overlay. 
Peripheral processor program. 
Peripheral processor unit program. 
Procedure record. 

Relocatable central processor program. 
Unrecognizable as a program. 
User library. 



The system library contains a maximum of 62 ULIB type records. If more records are 
added, only the first 62 can be assessed. 
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This section describes the system mechanisms used to initialize the fast-attach files used by 
MODVAL, PROFILE, and RESEX. 

ISF 

The ISF command initializes the fast-attach system files VALIDUs, PROFILa, RSXDid, and 
RSXVid. 1 A fast-attach file is a special direct-access file under user index 377777 8 that is 
initialized with the E parameter on the ISF command and released with the R parameter 
on the ISF command. However, in order to release a fast-attach file, an idle family situation 
must be present. That is, the job containing the ISF,R=filename command must be the only 
job in the family (family count is zero, and the direct-access file count equals the number of 
fast-attach files). Therefore, the DSD command IDLEFAMILY must be used to clear the 
system of all jobs. All current jobs and subsystems (such as maintenance jobs, MAGNET, 
and IAF) must be allowed to complete or be terminated. Refer to the family status display 
(E,F) in the NOS 2 Operations Handbook to determine when the above conditions have been 
met. 

The fast-attach file mechanism should be used by special system jobs for files that are to be 
retained as permanent files but have a high enough access rate to make permanent file 
ATTACHs excessively time-consuming. When a permanent file is activated as a fast-attach 
file, an entry in the system FNT is made that retains the basic data normally kept in the 
catalog entry and system sector of the file (interlocks and file name). This eliminates the 
catalog search and system sector read normally necessary to attach a permanent file. 

If the file is a shared (global) fast-attach file for a multimainframe network, additional 
information is also maintained in the fast-attach table on the link device. The type of file 
determines whether it is entered as global fast attach or local fast attach. This criterion is 
kept internal to ISF. Basically, VALIDUs and PROFILa are entered as global fast-attach 
files if they reside on a shared device. The resource files are always entered as local fast 
attach. A limit of 77 8 exists on the number of files that can be entered as global fast attach 
in a multimainframe environment. 

Because of the special nature of fast-attach files, a job containing an ISF command must be 
a system origin job. Processing the command causes a search of the system permanent file 
catalog (UI=377777 8 ) for files with the predefined names previously listed. They are defined 
in a table internal to ISF. 

The format of the ISF command is: 

SF , option, FM=f amilyname , SJ=f ilename , SP=f ilename . 



1. The resource files are generated and maintained separately for each machine id in a multimainframe or single mainframe system 
by appending the machine id to the file name (for example. RSXVid becomes RSXVAB on the machine with an id of AB). 
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Parameter 



Description 



option 



FM=familyname 



SJ=filename 



SP=filename 



Specifies whether to initialize or release system files. 



option 



Description 



E=filename System file that is initialized. If E=0 or no 

filename is specified (neither E nor R appear), all 
files defined in the ISF table are initialized (refer 
to table 20-1). 

R=filename Currently active system file that is released from 

fast-attach status. If R=0, all of the files in the ISF 
table for the specified family that are currently 
active are released. When this parameter is 
specified, an idle family situation (family count is 
zero, and the direct-access file count equals the 
number of fast-attach files) must first be created 
with the DSD command IDLEFAMILY. When the 
family is idle, the IDLEFAMILY command must be 
entered again so that the system will accept the 
ISF command. 

To release fast-attach system files, you must use 
this format of the ISF command: 

X. ISF (R=f ilename) 

Since initialization and release are mutually exclusive, E and R 
cannot appear on the same command. 

Family of devices. If FM is not specified, the calling job's current 
family is used. The calling job's family will be restored upon exit from 
ISF. 

Job file that ISF submits as a system origin job. The file must be an 
indirect-access permanent file stored under the system user index 
(377777 8 ). If SJ is specified without =filename, ISF assumes 
SJ=SYSJOB. If SJ=0 is specified, no job is submitted. 

Procedure file that ISF calls with system origin. The file must be an 
indirect-access permanent file stored under the system user index. If 
SP is specified without =filename, ISF assumes SP=SYSPROC. If 
SP=0 is specified, no procedure is called. 



ISF is automatically executed at each deadstart (refer to Deadstart Sequencing later in this 
section). This enables the use of SYSJOB and/or SYSPROC to SYSEDIT local modifications 
into the system. 

ISF can also be entered as a command from the console with the DSD X command or from 
any system origin job. 
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The matrix in table 20-1 shows how the initialize (E) and release (R) parameters affect 
individual fast-attach files. 

Table 20-1. Initialize and Release Parameters of Fast-Attach Files 



Name of 
Fast-Attach 
System File 



Initialize (E) Parameter 



Release (R) Parameter 



VALIDUs 
PROFILa 

RSXDid 
RSXVid 



Make global fast-attach file. 

Make local fast-attach file. If the 
file does not exist in the system 
catalog (UI=377777 8 ), ISF creates 
the file and makes it a fast-attach 
file. The file is created with the 
backup requirement set to none 
(BR=N). This prevents PFDUMP 
from dumping the file. If either 
RSXDid or RSXVid is specified, 
ISF initializes both files. 



Return from fast-attach status to 
normal direct access. 

Return from fast-attach status to 
normal direct access. If either 
RSXDid or RSXVid is specified, ISF 
returns both files to normal direct 
access. 



One use of the R parameter is to release fast-attach files activated on a device to be 
initialized or unloaded. Device initialization is not initiated as long as any direct- access 
files are active on the device (an activated fast-attach file is treated the same as an active 
direct-access file). Until these files are released, the system will reply to an attempted 
device initialization with the error message: 

ACTIVE FILES ON DEVICE 

Similarly, a device cannot be unloaded until all its fast-attach files are released. 
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Deadstart Sequencing 

Deadstart Sequencing 

During a level deadstart, a job is queued for input using the service class DSSC. This job 
executes the PP routine CMS, whose normal functions include mass storage initialization 
and recovery. After completing these functions, CMS checks its service class. If the service 
class is DSSC (indicating a deadstart sequencing call), CMS places one of the following ISF 
commands in its command buffer and causes the system to execute it. 

Command Description ^ 

i sf , fm= o , s J . Used for recovery deadstarts. 
isf, fm=0 , sj, sp. Used for other deadstarts. 

The CMS deadstart sequencing job begins execution only after job processing has been 
enabled by the DSD AUTO or MAINTENANCE command. The job scheduler prohibits 
scheduling of all other jobs until the CMS job completes, thereby ensuring that all system 
files in the default family are initialized and that a SYSPROC procedure (if any) is executed 
before normal job processing begins (refer to ISF earlier in this section). 



NOTE 



Since the deadstart job (including SYSPROC commands) must complete before normal job 
processing begins, avoid using SYSPROC for unnecessary or time-consuming tasks. SYSJOB 
may be more appropriate for some tasks. Also, SYSPROC cannot use tapes since MAGNET 
is not available. If SYSPROC uses removable disk packs, they must be mounted and ready. 
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ISHARED Device Updates 21-32 

ISHARED Seek Time 21-32 

ISHARED UpdatingTime 21-32 

Statistical Summary 21-33 

MTR Maximum Time 21-33 

Direct Moves 21-33 

Worst Case MTR Cycle Time 21-33 

Missed Clock Updates 21-33 

EM Moves 21-33 

Central Memory Moves 21-33 

Rollouts to MS 21-33 

Pseudo-Rollouts 21-33 

PCP Job Rollouts 21-33 

Secondary Rollouts 21-33 

Total Sectors Rolled 21-34 

Secondary Sec Rolled to MS 21-34 

Rollouts/User Limits 21-34 

Time Slices 21-34 

PP Priority Exchanges 21-34 

No Comm Buffer Avail 21-34 

No PCP Available 21-34 

EJT Scans 21-34 

Schedulable Jobs 21-34 

Jobs Preempted 21-34 

Jobs Scheduled 21-34 

Scheduled No Constraints 21-35 

Insufficient CM Scans 21-35 

Insufficient EM Scans 21-35 

No Control Point Scans 21-35 
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The TRACER and PROBE utilities described in this section provide data for statistical 
analysis of the system. The data is used to determine where problems occur and where 
improvements in design might be made, and to perform system tuning. The TRACER utility 
monitors the system's activity and gathers data periodically. The PROBE utility traps and 
measures particular internal events in the system. Both utilities capture valuable data that 
may not be obtainable any other way. 

Tracer Utility 

The TRACER utility monitors these conditions: 
Channel activity by channel. 
Channel reserved. 
Channel requested. 
Requests pending. 
Number of active PPs. 
Number of active concurrent PPs. 
Buffered input/output list parameters. 
Buffered input/output channel busy. 

CPU use (idle, system, subsystem, system-related activity, or user activity). 
Subsystem CPU use. 
Storage moves pending. 
PP saturation. 

Extended memory transfer in progress. 
MTR cycle time. 

CPUO or CPU1 is or is not in monitor mode. 
Same storage move request is pending. 
Control points in automatic recall (I) status. 
Control points in periodic or automatic recall (X) status. 
Control points in waiting (W) status. 
Amount of available memory. 

Amount of memory at control points by service class. 
Amount of memory in queue by service class. 
Amount of memory at control points by subsystem. 
Number of noninteractive jobs. 
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Number of detached interactive jobs. 

Number of online jobs. 

Number of preinitial jobs by service class. 

Number of executing jobs by service class. 

Number of jobs rolled out by job scheduler for each service class. 

Number of jobs rolled in or out by system control point processing for each service class. 

Number of jobs in a timed/event rollout queue by service class. 

Number of jobs rolled out by interactive input/output processing for each service class. 

Number of disabled jobs rolled out by service class. 

Number of suspended jobs rolled out by service class. 

Number of jobs with rollout file errors by service class. 

Number of EST entries in use. 

Number of FNT entries in use. 

Number of E JT entries in use. 

Number of queued files assigned to jobs at control points. 

Number of input files by service class. 

Number of print and punch files by service class. 

Number of other queued files not assigned to jobs at control points. 

Number of QFT entries in use. 

Number of FOT entries in use. 

Number of control points in use. 

Number of pseudo-control points in use. 

Number of IAF active users. 

Number of IAF pots available. 

Number of IAF pots in use. 

Number of tape drives in use. 

Number of tracks available by mass storage device. 

Number of segment table reads. 

Number of missed clock updates. 

Number of extended memory moves. 

Number of central memory moves. 

Number of all rollouts. 
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Number of rollouts to secondary rollout devices. 
Number of all sectors rolled. 

Number of sectors rolled out to secondary rollout devices. 
Number of rollouts/user limits. 
Number of time slices. 
Number of PP priority exchanges. 
Number of times communication buffer not available. 
Number of EJT scans. 
Number of schedulable jobs. 
Number of jobs preempted. 
Number of jobs scheduled. 
Number of jobs scheduled with no constraints. 
Number of insufficient CM scans. 
Number of insufficient EM scans. 
Number of no control point scans. 
Number of ISHARED table changes. 
Number of ISHARED device updates. 
Amount of ISHARED seek time. 
Amount of ISHARED updating time. 
The TRACER utility includes the following programs: 

Program Description 



ICPD A CPU program that initiates system monitoring by CPD. 

CPD A PP program that monitors any of the system activities just listed. CPD is 

dedicated to a PP while it is monitoring system activity. Data is written to a 
direct access permanent file for future analysis. 

ACPD A postprocessor program that generates an output report from the direct 

access permanent file written by CPD. 

ENDCPD A CPU program that terminates system monitoring by CPD. 
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Tracer Utility 

TRACER Commands 

TRACER commands are described next. 



ACPD Command 

ACPD reads the sample data file produced by CPD and generates reports, in both 
user-readable and machine-readable formats, for further analysis. The sample data file 
must be attached before ACPD is called. If ICPD is called with the M=A or M=M 
parameters, the sample data file can be accessed while CPD is still active. 

ACPD assumes a continuity of the sample data file. Therefore, the uncollected information 
during the time gap separating two consecutive files is assumed to be present, although the 
information is not reported. As a result, if the consecutive files on the sample data file are 
not in chronological order, ACPD terminates and issues an error message. 

Format: 



ACPD,p 1 ,p 2 ...p n . 



Pi 



Description 



FN=datafile Name of sample file. Default is SAMPLE. This file is not rewound before 

or after processing. 

L=outfile Name of output file generated by ACPD. Default is OUTPUT. 

S=sumfile Name of machine-readable summary file generated by ACPD. If this 

parameter is omitted, no summary file is generated. If S is specified 
without sumfile, SUMMARY is assumed. 

IC=nn Select the report interval by specifying the number of CPD sample file 

records. This allows selection of report intervals of less than 1 minute. 
You can specify the report interval by using either the IC or IN 
parameter, but not both. 

IN=nn Time span of report interval, in minutes. Default value is 6 minutes. 

ACPD generates a report for each report interval. You can specify the 
report interval by using either the IN or IC parameter, but not both. 

LO=Z Report data items with zero values. Default is to suppress data items 

with zero values. 

N=nn Number of files on the sample data file to be analyzed and reported. 

Default is only one file processed. If N is not equivalenced, all files are 
processed until EOI is reached on the sample data file. The sample data 
file is not rewound before processing. 

BT=hhmmss Beginning time in the form hour minute second. If BT=hhmmss is 
specified, only data collected after this time on the date specified by 
BD=yymmdd is reported. If BT is omitted or no time is specified, BT=0 
is assumed. 
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Pi 



Description 



ET=hhmmss Ending time in the form hour minute second. If ET=hhmmss is specified, 
only data collected before this time on the date specified by ED=yymmdd 
is reported. If ET is omitted or no time is specified, ET=0 is assumed. 

BD=yymmdd Beginning date in the form year month day. If BD=yymmdd is specified, 
only data collected on or after this date is reported. If BD is omitted or 
no date is specified, the beginning date is the date of the current file on 
the sample data file. 

ED=yymmdd Ending date in the form year month day. If ED=yymmdd is specified, 

only data collected on or before this date is reported. If ED is omitted or 
no date is specified, but ET=hhmmss is specified, the ending date is the 
same as the beginning date. If neither ED nor ET is specified, ACPD 
terminates when the number of files specified by the N parameter are 
processed, or end-of-information is encountered, whichever happens first. 

ACPD begins by processing the command parameters. If the begi n ning time (BT) and 
beginning date (BD) are specified, ACPD first locates the correct file and then processing 
begins. Processing continues until the ending time (ET) and ending date (ED) are 
encountered, the number of files specified by the N parameter have been processed, or 
end-of-information is encountered, whichever happens first. 

If the BT and BD parameters are not specified, ACPD starts at the current position of the 
sample data file. The sample data file is not rewound before processing starts. 

ENDCPD Command 

The ENDCPD command terminates all CPD data gathering. 
Format: 

ENDCPD. 
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ICPD Command 



ICPD defines a mass storage file to which CPD will write statistical data and then initiates 
system monitoring by CPD. 

NOTE 



If you want the statistical data to include only data from the start of this TRACER run 
rather than an accumulation of data from the last deadstart, enter the command 
PROBE(OP=C,L=0) before entering the ICPD command so that the statistical data area of 
CMR will be cleared prior to the reporting done by CPD. 



Format: 



ICPD,p 1 ,p 2 , .. .p n . 



Pi 



Description 



FL=fl Fast loop sampling frequency, in milliseconds, during which items such 

as PPs active and move request pending are sampled. Default is 5 
milliseconds. 

ML=ml Medium loop sampling frequency, in milliseconds, during which items 

such as control points in I, X, and W status and field length available 
are sampled. Default is 100 milliseconds. 

SL=sl Slow loop sampling frequency, in milliseconds, during which items such 

as IAF users and tape drives in use are sampled. Default is 1000 
milliseconds. 

FW=fw Snapshot loop sampling frequency, in seconds. Default is 5 seconds. 

FN=filename Name of sample data file. Default is SAMPLE. ICPD will attempt to 
attach a direct access file by this name. If no file exists, it will be 
defined. If a file is found, ICPD will skip to EOI and write an EOF. CPD 
will then start writing data after the EOF. 

M=mode Permanent file mode for sample data file. Default is M=WRITE. mode 

can have one of these values: 



mode 



Description 



WRITE or W 
APPEND or A 
MODIFY or M 



Sample data file attached in write mode. 
Sample data file attached in append mode. 
Sample data file attached in modify mode. 
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NOTE 



If the sample data file is attached in write mode, the file cannot be accessed until ENDCPD 
is run. If the sample data file is to be accessed while data is being collected, append or 
modify mode must be specified. In this situation, the file may be attached in read/allow 
modify (KM) mode. (Attaching the file in write mode rather than in modify or append mode 
expends less overhead when interlocking and writing the data file.) 

If a loop time is set to (zero), no samples for that loop will be taken. If the data block 
sample time is set to (zero), the data file will be written only when the sampling interval 
terminates. 

All numeric data should lie within the range through 4095 (0 through 7777 8 ). 



Output File Format 



The first three pages of the output report produced by ACPD contain the header block 
information. Next the data items are reported for fast, medium, and slow loop samples. The 
report ends with the snapshot data items. 

Figure 21-1 is an example showing the format of the output report. The example has been 
simplified and condensed to reduce the amount of output. Also, supporting text has been 
added to the example. 

Data items monitored at successive time intervals are listed in the same row. For each data 
item, the average, standard deviation, and percentage are listed in successive rows. Up to 
10 intervals can be listed per page in successive vertical columns. If the output file contains 
more than 10 columns per row, the output report lists the first 10 columns for all rows of 
data items and then resumes listing subsequent intervals following the snapshot data items. 

The SUBTOTAL column contains the values of the data items for the time spanned by the 
preceding intervals on the current page; that is, the time spanned by the preceding 
intervals is considered one interval. The TOTAL column appears after the last interval 
reported and contains the statistical values of the data items for the entire run. The 
SUBTOTAL column is not listed if the subtotal data and total data are identical and would 
appear on the same page. In this case, only the TOTAL column is fisted. The SUBTOTAL 
and TOTAL columns are not reported for the snapshot data items. The *MAX* and *MIN* 
columns appear at the end of the report and contain the maximum and minimum interval 
values of the data items for the entire run. The maximum and rninimum interval values on 
each page are indicated by brackets and parentheses, respectively. 

The average is not reported for data items that have a weighting factor of 1, and the 
percentage is not reported for data items that have a weighting factor of 100, since this 
information is redundant. 
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Figure 21-1. Example of TRACER Output (Continued) 
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Figure 21-1. Example of TRACER Output (Continued) 
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Figure 21-1. Example of TRACER Output (Continued) 
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00.02.13 


00.06.12 


00-06.13 


00.O5.13 00:18 W> 


tUTOMW. 


laww. 


IHTEHML 


uranm. 


I0TEMU. 


mtes«u. sisronu. 


10517 


10520 


1052* 


10S16 


10507 


10517 


94623 


7.106 


C7.7083 


4.5S2 


4.506 


4.250 


4.15* 


5.SS9 


0.151 


C0.3631 


0.250 


0.034 


0.021 


0.143 


1.201 


35.931 


■38. S»] 


22.760 


22.51* 


21.250 


30.no 


27.493 


0.000 


0.000 


O.OOO 


0-000 


0.000 


[0.001] 


(.001 


0.000 


t0.1»3 


0-068 


0.000 


0.000 


0.067 


0.035 


Q.OBO 


0.000 


O.OOO 


a. ooo 


0.0JO 


0.000 


0.000 


0.000 


o.ooc 


0.000 


O.000 


0.000 


0.090 


0.000 


0.000 


0.001 


0.000 


tO.0013 


CD.0N> 


O.OOO 


0.001 


0.095 


0.20» 


0.162 


CO.2091 


0.006 


0.057 


0.125 


a.taa 


0.612 


0.572 


0.370 


(0.566 > 


0.(33 


0.392 


(a. ooo) 


0.1*3 


0.007 


0.0*1 


0.0M 


[0.(E33 


0.029 


0.00* 


C.0D3 


(0.0021 


0.010 


fi.002 


0.005 


0.020 


11 3.605 J 


10.961 


(.200 


9.170 


0.376 


9.106 


9.895 


0.000 


O.OOO 


0.000 


0.0D0 


O.OOO 


O.OOO 


o.aoo 


0.000 


0.000 


0.000 


O-000 


O.OOO 


0.O09 


0.000 


o.m 


0.022 


0.01 9 


0.001 


0.001 


tD.069] 


0.007 


15.915 


C19.T3*) 


7.051 


5.696 


5.KK 


12.110 


9.245 


0.000 


0.05ft 


O.OOO 


0.001 


O.OOO 


CO. 068) 


0.034 


0.045 


3.776 


0.045 


0.09S 


<0.B3S> 


C6.09S. 


1.250 


<S.003> 


0*053 


O.0S9 


0.016 


0.005 


01.275) 


0.16* 


16.810 


12.9H 


19.718 


25.217 


<7.*S4) 


53.625 


19.383 



© © 



© 
© 
© 
© 

© 

© 
© 



The interval ending tin i» »h<»» at the top of eac* report »1«. Toe report interval Is opacified by the "= or IH 

paraeeter of the AC7D < 



The saapllea. freeeaecr lor fut loop 1M l» opacified »J the TU peraeater of Che ICTO coeaend. Refer to cobl. tl-l tor 
•11 feet loop tteea that TRACSR report*. Part loop tteaa oro deecrthfti* Following the table- 

The unlKKt report** (or exit dm Ice. are the >«<(< »•). iwtoo deeUtio* (»>, aed perorata** («> for the report 
Interval. 

the SUtTOTAL coloso contain* a .aojiutioo of ell date gathered from an Interval* of each page. Tel. colon It not listed II 
the ouotecal dec* eed the ulal data ace identical eod eoold appear oo the aaae page. 

Thl. esaaale ha. 13 ce.ee*> of mfemetleo lot each to> of data tton*. •ouowr, eel, 10 colon", can he shoe, per page, eo 
the renaming cole*** are listed at the eod of Che resort. 

The valves enclosed io nracket* are the eonlnon interval valau for each too- of data ltena o» each page, tefer to oote Qi). 

The •alee* enclosed 1» nafeatheaa* are the aieieua Interval valves for each re» of dace liens o» eoer. page . 
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Figure 21-1. Example of TRACER Output (Continued) 
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Tracer/Probe Utilities 21-11 



Tracer Utility 



u k»i smut 




ttTS 


tin 


1175 


1175 


1175 


1175 


1175 


1173 


1175 


I0S44 


nr 


(C225) 


CS39 


0.809 


LOW 


C2-494J 


1.499 


2.0*5 


1.202 


1.270 


1.351 




s» 


0.0>3 


0.144 


0.3201 


0.111 


0.213 


eo.002) 


0.122 


0.134 


0.T37 


0.747 




PC 


(O.0O5) 


1.109 


5.175 


4.471 


10.907] 


4.047 


7.444 


4.579 


4.544 


4.825 


(Km status 


»v 


(3.HT) 


t.va 


5.094 


C6.S21 


4.070 


5.904 


4.0B0 


5.027 


4.079 


4.TM 




so 


0.020 


0.01* 


(0.003) 


0.044 


0.101 


0.009 


0.142 


tO.IM] 


0.159 


C32» 




Ft 


ca).«»> 


s.ou 


21.052 


[24.295] 


21.705 


21.091 


21.714 


20.011 


21.712 


21.71* 


en in l sniK 


» 


(0.047) 


0.1» 


0.00 


C0.1BS] 


0.177 


0.091 


0.095 


COTS 


0.141 


0.114 




a> 


(0.001 J 


0.OI4 


o.as 


0.004 


O.0OS 


0.011 


COM 


0.002 


[0.075] 


0.049 




PC 


<C2H) 


0,4*5 


0.295 


[C4411 


0.412 


0.325 


0.540 


C240 


0.505 


0.414 


SUE MW KOKS7 


SB 


C0» 


o.ooo 


0.000 


0.090 


O.OOO 


0.000 


0.000 


O.OOO 


0.000 


O.OOO 




PC 


0.000 


0.000 


0.000 


0.000 


8.000 


0.000 


COM 


COOO 


COOO 


COX 


FL JtVASJBlU 


*¥ 


[WW 


4254B 


55458 


2475B 


247W 


30170 


424120) 


5375* 


3140B 


32500 




5» 


CI. 227) 


7.470 


22.147 


02. 904 


C1Z«.?<03 


5.241 


4C941 


9.914 


117.505 


337.442 




PC 


at.noi 


59.7*0 


4S.MS 


39.754 


34.213 


42.014 


(34.957) 


4B.4S9 


44.195 


44.143 


user n awium 


w 


OB 


0B 


09 


OB 


OB 


0» 


OB 


OB 


OB 


OB 




SB 


0.000 


0-000 


O.OOO 


0.000 


O.OOO 


O.OOO 


O.OOO 


0.000 


0.000 


O.OOO 




ft 


0.000 


0.000 


0.000 


con 


0.000 


cooo 


COOO 


cooo 


cooo 


cow 


MM NrrCUCTlVE JOBS 


»¥ 


o.aa> 


2.0% 


2.440 


4.245 


t4.5»t] 


2.003 


2.351 


2.191 


3.590 


3.04O 




S» 


0.154 


(0.023) 


0.454 


ic«m 


0.139 


C*«2 


C2S8 


COW 


C170 


1.5J4 




PC 


10.177) 


0.JH 


0.445 


0.757 


11. 144) 


0.457 


0.408 


o.sn 


0.425 


0.520 


6E1KHE0 JOBS 


« 


0.000 


COOO 


O.OOO 


cooo 


con 


con 


con 


con 


COOO 


COOO 




St 


0.B» 


O.OOO 


o.oto 


o.m 


0.000 


O.OOO 


O.OOO 


0.090 


0.000 


O.OM 




PC 


0.000 


0.008 


O.OOO 


0.000 


con 


COM 


COM 


0.000 


cooo 


COM 


0M1UC JOBS 


M 


i.on 


1.000 


1.000 


1.000 


i.on 


1.CO0 


1.000 


1.000 


1.000 


I.OM 




s» 


COM 


COM 


COM 


0.000 


0.000 


COM 


con 


cow 


COM 


COOO 




PC 


C174 


0.174 


o.m 


0.174 


0.174 


0.174 


0.174 


0.17* 


C174 


0.174 


FK-MITIM. JOB so 
















I 








JY 


« 


<1.O00> 


LOW 


1.001 


1.02* 


1.0M 


I.OM 


I.OM 


1.001 


C1.344? 


1.042 




st 


<cooo> 


9.000 


0.001 


C029 


0.000 


0.000 


cooo 


COOT 


CO. SMI 


CIST 




K 


(0.17* > 


0.17* 


0.174 


0.179 


0.174 


0.174 


0.174 


0.17* 


D.233) 


0.111 


K 


Ml 


<C025> 


1.0W 


0.4*4 


1.164 


11.44$] 


0.094 


C234 


0.092 


0.442 


0.605 




» 


C025 


(0.090) 


0.125 


0.144 


0.335 


0.094 


0.234 


0.029 


C0.4421 


0.5(2 




PC 


CCOOM 


CI 74 


C119 


C202 


CC20) 


0.O14 


0.041 


0.014 


COOO 


0.105 


n 


»¥ 


0.000 


COM 


o.on 


O.OOO 


0.000 


0.000 


0.000 


COM 


O.OOO 


o.on 




S» 


con 


turn 


COOO 


COOO 


con 


cooo 


cooo 


COOO 


COOO 


COM 




K 


o.«n 


.0.000 


0.0H 


o.on 


o.on 


0.000 


con 


0.000 


0.000 


O.OM 


IS 


MM 


0.00B 


COM 


0.000 


con 


cooo 


cooo 


con 


cooo 


0.000 


COM 




SB 


COM 


0.000 


0.000 


0.000 


o.ooo 


O.OOO 


o.on 


O.OOO 


O.OOO 


O.OOO 




PC 


0.000 


CM0 


0.000 


cooo 


con 


con 


con 


COM 


COM 


COM 



© 
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Figure 21-1. Example of TRACER Output (Continued) 
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Tracer Utility 



SIM VOW SMHES 




119 


11? 


119 


11 9 


11 9 


119 


119 


119 


119 


1071 


Mf uses 


M 


1.000 


1.000 


1.000 


1.000 


1.000 


1.000 


1.000 


1.009 


1.000 


1.000 




SB 


0.000 


0.000 


o.ooo 


o.ooo 


O.000 


o.ooo 


0.090 


0.990 


0.000 


0.000 




PC 


0.701 


0.7*1 


0.7*1 


0.7*1 


0.7*1 


0.7*1 


0.7*1 


0.7*1 


0.7*1 


0.7*1 


IW (UTS 4UOC1TEB 


» 


455.000 


455.000 


455.000 


435.100 


455.000 


455.000 


455.000 


455. mo 


455.000 


455.000 




SB 


0.000 


0.000 


O.000 


o.ooo 


o.ooo 


0.000 


0.000 


o.ooo 


0.000 


o.ooo 


IM POTS IK USE 


H 


ci«.ox» 


143.000 


19J.017 


153.00* 


195.017 


[197.297.1 


193.000 


193.000 


199.00* 


193.4*2 




SB 


(0.000> 


turn 


0.000 


0.COS 


0.017 


ti.Z«7j 


0.O0O 


0.000 


0.000 


1.1*7 




K 


<42.41t> 


42.410 


42.421 


42.419 


42.4JI 


[43.342] 


42.41* 


42.41S 


42.41* 


42.524 


■CUE HUS ASSMHEB 


AV 


(O.OOO) 


0.00* 


0.009 


0.000 


0.050 


0.0)0 


9.000 


O.000 


C0.042) 


0.01* 




SB 


(0-000) 


0.990 


0*090 


0.00* 


o.oso 


0.0)0 


0.000 


O.OM 


w.tmi 


0-O4B 




PC 


(0.000) 


COCK 


0.000 


a. ok 


0.012 


0.000 


0.000 


9. 009 


C0.0233 


0.004 


mwr files 

ST 


»¥ 


0.Q0O 


0.000 


0.000 


0.0M 


0.000 


0.0)0 


0.000 


o.ooo 


0.000 


o.ooo 




SB 


0.000 


C.0O0 


0.000 


0.000 


0.000 


0.009 


0.000 


0.000 


0.000 


o.ooo 




ft 


0.000 


0.030 


o.ooo 


0.000 


o.ooo 


0.000 


0.990 


0.000 


o.ooo 


o.ooo 


*c 


«¥ 


0.000 


o.ooo 


0.000 


0.000 


0.000 


0.099 


0.000 


0.000 


0.090 


o.ooo 




SB 


11. ceo 


O.OM 


0.0W 


o.eoo 


O.OM 


0.090 


0.000 


o.ooo 


o.ooo 


o.ooo 




PC 


0.000 


O.ooo 


0.000 


o.ooo 


O.000 


0.000 


0.000 


0.000 


0.000 


0.000 


IB 


JW 


0.000 


0.000 


0.000 


o.ooo 


O.OM 


0.100 


o.ooo 


0.090 


0.000 


0.000 




SB 


0.000 


0.001 


o.ooo 


0.000 


0.000 


0.000 


0.000 


0.080 


0-009 


0.000 




PC 


0.090 


o.ooo 


0.000 


0.100 


o.ooo 


o.ooo 


0.090 


0.000 


0.000 


o.ooo 


TS 


M 


O.000 


0.000 


0.000 


0.000 


o.ooo 


0.0)9 


0.000 


0.000 


0.000 


0.000 




SB 


0.000 


o.ooo 


O.OM 


o.ooo 


o.ooo 


o.ooo 


0.090 


0.009 


0.0*0 


O.000 




PC 


0.000 


0.000 


0.000 


0.000 


0.000 


0.000 


0.000 


0.009 


0.000 


0.000 


ntmr rites 
sv 


AV 


<D.oa» 


0.000 


o.ooo 


o.ooo 


co.oo*: 


o.ooo 


o.ooo 


0.000 


o.ooo 


0.001 




SB 


<C0Ot» 


0.000 


0.000 


0.000 


CO.OO0) 


0.100 


OJBOO 


0.000 


o.ooo 


0.004 




PC 


(O.OOO) 


0.000 


o.ooo 


0.000 


EO.OK] 


o.ooo 


0.000 


0.000 


0.000 


0.060 


BC 


AV 


0.000 


0.001 


0*000 


0.000 


0.000 


0.O3O 


0.0*0 


0.000 


O.000 


o.ooo 




SB 


0.000 


0.000 


0.0B9 


0.000 


a.an 


o.ooo 


0.090 


0.000 


0.090 


0.000 




PC 


0.000 


0.000 


o.ooo 


0.000 


corn 


0.000 


0.000 


0.000 


0.000 


0.000 


gg 


JUT 


9.000 


0.OD0 


0.0M 


o.ooo 


o.ooo 


5.030 


0.000 


0.000 


0.000 


o.ooo 




SB 


0.000 


0.010 


0*000 


o.ooo 


O.900 


0.000 


0.000 


0.000 


0.000 


0.000 




PC 


0.000 


o.ooo 


o.ooo 


0.000 


0.090 


0.090 


0.000 


o.ooo 


o.ooo 


0.000 


TS 


tot 


0.000 


0.000 


0.090 


0.090 


0.000 


0.990 


o.ooo 


0.000 


0.000 


0.000 




SB 


•.ODD 


0.000 


0.090 


o.ooo 


0.000 


0*090 


0.000 


o.ooo 


9.000 


a. on 




PC 


0.000 


0.0*0 


0.000 


0.0*9 


0.000 


0.090 


OLOOD 


0.000 


0.000 


0.000 




PC 


o.ooo 


0.000 


0.090 


o.ooo 


0.400 


0.090 


0.000 


0.000 


o.ooo 


0.000 







The smpUxe CT«4smcr tor »l«n loof lceBS Is tpetlftt* by the SI nnuai of the IBS 

>«c all •*<« loot -"»• <•" TUCK* roport*. $!<*• loop sua* an dMectM lellwl-* CM i«M«. 
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Figure 21-1. Example of TRACER Output (Continued) 
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Tracer/Probe Utilities 21-13 



Tracer Utility 



(ll) SUM SHOT Of tRSL 
w <W0L> * 


































0*00 0000 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


oooo 






oooo 0000 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


oooo 






0000 0000 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


oooo 






oooo oooo 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


0900 






0200 0200 


Q200 O200 


0200 


oeoo 


oeoo 


0200 


0200 




'cano » 


oooo oooo 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


oooo 






0000 0000 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


ODDS 






oooo oooo 


•000 oooo 


oooo 


oooo 


oooo 


oooo 


0900 






oooo oooo 


oooo oooo 


0300 


oooo 


oooo 


oooo 


oooo 






oooo oooo 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


oooo 




<XHlL> - 


oooo oooo 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


oooo 






oooo oooo 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


oooo 






oooo oooo 


oooo oooo 


oooo 


oooo 


0800 


oooo 


oooo 






oooo oooo 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


oooo 






oooo oooo 


ono oooo 


0900 


oooo 


0100 


oooo 


oooo 




(SOU ■ 


■000 oooo 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


oooo 






oooo oooo 


oooo oooo 


OOOO 


0000 


oooo 


ODOO 


ODOO 






•000 oooo 


oooo oooo 


oooo 


0000 


oooo 


OOOO 


oooo 






oooo oooo 


oooo oooo 


0900 


0000 


oooo 


oooo 


oooo 






oooo oooo 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


oooo 


Installation are» 
tree cm* 


{mo - 


oooo oooo 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


oooo 




oooo oooo 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


oooo 




oooo oooo 


0000 ONO 


oooo 


oooo 


oooo 


oooo 


ODOO 






oooo oooo 


oooo OOOO 


oooo 


oooo 


oooo 


oooo 


oooo 






oooo oooo 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


oooo 




UMU - 


oooo oooo 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


oooo 






oooo oooo 


oooo oooo 


oooo 


DOOO 


oooo 


oooo 


oooo 






0000 oooo 


oooo oooo 


oooo 


OOOO 


oooo 


oooo 


oooo 






oooc oooo 


oooo oooo 


oooo 


oooo 


ODOO 


ODOO 


oooo 






oooo oooo 


oooo oooo 


OBOO 


oooo 


oooo 


oooo 


oooo 




C1ML> * 


oooo oooo 


■000 oooo 


OOOO 


oooo 


0900 


oooo 


oooo 






oooo oooo 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


oooo 






oooo oooo 


oooo oooo 


oooo 


oooo 


9000 


oooo 


oooo 






oooo oooo 


OBOO MOB 


oooo 


oooo 


oooo 


oooo 


oooo 






DOOO OOOO 


OQfln OOOO 


oooo 


oooo 


00*0 


oooo 


oooo 




CW7L) = 


oooo oooo 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


oooo 






9000 oooo 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


oooo 






oooo oooo 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


oooo 






oooo oooo 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


ODOO 






oooo oooo 


oooo oooo 


oooo 


oooo 


oooo 


oooo 


oooo 




00 irbe sampling fraaaiaay for 


wnprtwt loop Itwm 


is «f«d£l«4 by tit* TV i»r<muT »£ ih* 


XOPO coMaod. 







Figure 21-1. Example of TRACER Output (Continued) 
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Tracer Utility 



A C P D - VER 9.4 (31) 


CY180-860 SN302. OPEN SHOP. 


NOS 750C2/24R1/3A. 


Date/Time 


6 MINS INTERVAL 


13 


.02.05 








INTERVAL 






MTR MXN TIME 




436 






WORST CASE MTR CYCLE TIME 




4037 






MISSED CLOCK UPDATES 











EM MOVES 











CM MOVES 




49 






DIRECT MOVES 




41 






ROLLOUTS TO MS 




53 






PSEUDO-ROLLOUTS 











PCP JOB ROLLOUTS 











SECONDARY ROLLOUTS 




30 






SECTORS ROLLED TO MS 




9228 






SECONDARY SEC ROLLED 




3099 






ROLLOUTS/USER LIMITS 











TIME SLICES 




28 






PP PRIORITY EXCHANGES 











NO COMM BUFFER AVAIL 











NO PCP AVAILABLE 











EJT SCANS 




437 






SCHEDULABLE JOBS 




79 






JOBS PREEMPTED 











JOBS SCHEDULED 




54 






SCHEDULED NO CONSTRAINTS 











INSUFFICIENT CM SCANS 











INSUFFICIENT EM SCANS 











NO CONTROL POINT SCANS 












Figure 21-1. Example of TRACER Output (Continued) 
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Tracer Utility 



A C P D - VER 9.4 (31) CY180-860 SN302. OPEN SHOP. NOS 750C2/24E1/3A. Date/Time 
6 MINS INTERVAL 13.02.05 
INTERVAL 



PRG MD FUNCTIONS TIME 



STORAGE MOVE TIME 



PSEUDO-PP TIME 



CPU IDLE TIME 



CPU 1 IDLE TIME 



SNAP SHOT OF RTCL 



SNAP SHOT OF PDTL 



0000 
0000 
0245 
7164 
0240 

0000 
0000 
0013 
0701 
6700 

0000 
0000 
0000 
0000 
0000 

0000 
0017 
5253 
4501 
1200 

0000 
0000 
0000 
0000 
0000 

0040 
0370 
0000 
0075 
0106 

0000 
0000 
2403 
1015 
0205 



Figure 21-1. Example of TRACER Output (Continued) 
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Figure 21-1. Example of TRACER Output 



Summary File Format 

The machine-readable summary file has two types of records, the header block record and 
the data block record. An *EOR* separates consecutive records. 

The header block record contains the header data in an unpacked format. 

Each data block record is divided into two equal length parts. The first part contains the 
average values of the data items. The second part contains the corresponding standard 
deviations of the data items. 

Total and subtotal data and interval percentage data does not appear on the summary file. 
The loop sample times and snapshot data items have standard deviations to simplify the 
summary file format. 
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Data Items Reported by TRACER 

The data items reported by TRACER are described in the following paragraphs and are 
summarized in tables 21-1 through 21-3. TRACER increments each item's counter when the 
item is in a given state, and periodically writes the contents of the counters to the data file 
for future processing by ACPD. When and how the counter for a given item is incremented 
is also discussed. 

Suggestions are given to help you determine system performance. Performance may be 
affected by several areas within the system; therefore, a full analysis should be done prior 
to making any changes. 

Table 21-1. Fast Loop Data Items 



Fast Loop Items 



Weighting Factor 



Fast loop samples 

PPs active 

Move request pending 
No PP available 
No CPP available 
EM transfer in progress 
MTR cycle time 
Monitor mode — CPUO 
Monitor mode — CPU1 
Scheduler active 
Channel reserved 
Channel active 
Channel requested 
Requests pending 
Buffered I/O lists 
Buffered I/O channel busy 
CPU usage — CPUO 
CPU usage — CPU1 
Subsystem CPU usage 



None 

Number of PPs available 

ll 

1 

1 

1 

100 2 

1 

1 

1 

1 

1 

1 

100 

Number of I/O buffers 

1 

1 

1 

1 



1. The average value will not be reported if the weighting factor is 1. 

2. The percentage value will not be reported if the weighting factor is 100. 
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Table 21-2. Medium Loop Data Items 



Medium Loop Items 



Weighting Factor 



Medium loop samples 

CPS in W status 
CPS in X status 
CPS in I status 
Same move request 
FL available 

User EM available 

Noninteractive jobs 

Detached jobs 

Online jobs 

Preinitial job step 

Executing 

Scheduler rollout 

SCP rollin 

SCP rollout 

Timed/event rollout 

Interactive rollout 

Disabled rollout 

Suspended rollout 

Rollout file error 

EJT entries in use 

FL at control points 

FL at pseudo-control points 

FL in rollout queue 

EM memory at control point 

EM memory at pseudo-control point 

EM in rollout queue 

Subsystem FL 



None 

Number of control points 
Number of control points 
Number of control points 
1 

Available field length 
(machine size — CMR size) 
Available user extended memory 
field length 

Number of EJT entries 
Number of EJT entries 
Number of EJT entries 
Number of EJT entries 
Number of EJT entries 
Number of EJT entries 
Number of EJT entries 
Number of EJT entries 
Number of EJT entries 
Number of EJT entries 
Number of EJT entries 
Number of EJT entries 
Number of EJT entries 
Number of EJT entries 
Available field length 
Available field length 
Available field length 
User extended memory size/1000g 
User extended memory size/1000g 
User extended memory size/1000 8 
Available field length 
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Table 21-3. Slow Loop Data Items 



Slow Loop Items 



Weighting Factor 



Slow loop samples 

IAF users 
IAF pots allocated 
IAF pots in use 
Queue files assigned 
Input files 
Print files 
Punch files 
Other queue files 
QFT entries in use 
Tape drives in use 
Tracks available 

CPPs active 

ISHARED table changes 
ISHARED device updates 
ISHARED seek time 
ISHARED updating time 



None 

Number of terminals defined 

100 

IAF pots allocated 

Number of QFT entries 

Number of QFT entries 

Number of QFT entries 

Number of QFT entries 

Number of QFT entries 

Number of QFT entries 

Number of available tape drives 

Maximum number of tracks for 

monitored device 

Number of CPPs available 

None 

None 

None 

None 
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Fast Loop Items 

The following paragraphs describe fast loop items. Fast loop items are continuously 
changing, so they should be sampled frequently. 

Fast Loop Samples 

TRACER increments the fast loop samples counter each time the fast loop items are 
sampled. 

PPs Active 

TRACER increments the PP active counter for each active PP it finds when scanning the PP 
communication area. Disabled PPs (those turned off at deadstart time) are not considered 
active. An active PP is one that has a nonzero input register. MTR (PPO) and DSD (PP1) 
are always counted as active PPs. 

If this counter's percentage exceeds 80 percent and the no PP available counter is greater 
than 20 percent, you may need more PPs. Check the channel active counters for disks. If 
the disk channels range from 35 to 40 percent, you may not need additional PPs; instead, 
look at what is causing your disk channels to be so busy. If you can reduce their activity to 
below 30 percent, the percentages should also drop for the PPs active counter and the no PP 
available counter. 

Examine which PPs are dedicated. If the percentage of floating PPs is low (about 20 percent 
of the total PPs configured), you may need more PPs. 

Move Request Pending 

TRACER increments the move request pending counter whenever it determines, from word 
CMCL of CMR, that a storage move request is outstanding. 

If this counter's percentage ranges from 30 to 40 percent, the system is degrading. The 
following items could cause excessive storage movements. 

• Are subsystems at the highest or lowest control points? If not, NOS may be moving 
them up or down in memory frequently in order to satisfy other user job memory 
requests. If a subsystem like NAM is being moved, its users may experience slow 
response time since a subsystem cannot execute while it is moving in memory. 

• Try to stabilize the field lengths of your subsystems. For example, if TAF is not built 
correctly for your site's use, it may roll out and roll in quite often. Depending on your 
CM constraints, you may want TAF to roll out less frequently. You should evaluate 
each subsystem and place it at the correct control point. 

• Are some user jobs changing their field length excessively? For example, jobs that open 
and close many files repeatedly cause CMM to adjust the user's field length, which 
causes other job movement within memory. This may save on field length but takes 
resources from the sytem, which increases system overhead. This type of job should be 
changed to be more efficient. 
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No PP Available 



TRACER increments the no PP available counter each time it determines, from word PPAL 
of CMR, that there are no PPs available. 

The percentage for this counter should be examined with the percentage for the PP active 
counter. If the PP active percentage is low (less than 50 percent) but you have counts of no 
PPs available, it means that you have peaks in your work load and this may be acceptable. 
However, if the PP active percentage is high (from 80 to 90 percent) and you have counts of 
no PPs available, you may need more PPs. 



No CPP Available 

TRACER increments the no CPP available counter each time it determines, from word 
PPAL of CMR, that there are no CPPs available. 



EM Transfer in Progress 

TRACER increments the extended memory transfer in progress counter whenever the S/C 
register (maintenance register for models 865 and 875) indicates an extended memory 
transfer is active. This data is available for CYBER 170 Computer Systems except models 
176, 815, 825, 835, 845, and 855. 



MTR Cycle Time 

TRACER increments the MTR cycle time counter by the cycle time for the last MTR cycle. 
This item indicates how fast MTR is completing one complete scan of all PP output registers 
and processing those functions present. 

The MTR cycle time should not exceed 0.5 seconds. If it does, MTR could miss updating the 
real time clock. Refer to MTR MXN TIME reported in the statistical data area from CMR 
(figure 21-1) for the worst case. 



Monitor Mode — CPU0/CPU1 

TRACER increments the monitor mode counter for CPU0/CPU1 whenever the S/C register 
(maintenance register for models 865 and 875) indicates that the CPU0/CPU1 is in monitor 
mode. This data is available for CYBER 170 Computer Systems except models 815, 825, 
835, 845, and 855. 

During monitor mode, the CPU is executing the code of CPUMTR, which performs NOS 
overhead. During program mode, CPUMTR is executing to perform a function that a user 
job requested and only CPUMTR has the capability or security to do. 

When the monitor mode counter reaches 20 percent for each CPU on a dual CPU 
configuration or 30 percent for a single CPU machine, you should examine the data 
provided by PROBE. PROBE reports each monitor request for both monitor mode and 
program mode. Examine the requests to determine what functions were called in excess. As 
a basis of comparison, use a PROBE report for which system performance was good and the 
monitor mode statistics were normal. 
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Scheduler Active 

TRACER increments the scheduler active counter whenever it determines that the job 
scheduler (1SJ) is active. The job scheduler is considered active when the scheduler active 
flag in word JSCL is set. 

The job scheduler is called to process input queues and rollout queues. The scheduler 
searches all of the corresponding queues, starting with the last EJT or QFT entry scheduled 
to a control point. It schedules the highest priority jobs into execution. Queue length and 
decision processing determines the amount of time the scheduler spends, limit the size of 
the queues to the amount shown in the EJT entries in use and the QFT entries in use 
statistics. 

If the scheduler active counter reaches 70 to 90 percent, you may notice problems. The 
reason is that 1SJ is called to process EJT entries or QFT entries, not both. For example, if 
1SJ spends all of its time processing EJT entries, no input queue jobs are processed. In this 
case, interactive users entering the system for the first time will never get started. Also, 
excessive rollin/rollout because of central memory constraints or CM/CP time slice 
expirations could cause the scheduler to be busy. Examine the SERVICE parameters; you 
might have to do some tuning. 

Channel Reserved 

TRACER maintains a channel reserved counter for each available channel or concurrent 
channel and increments a counter whenever its channel is logically reserved by the 
operating system. TRACER samples the channel status table for this data. 

A PP program may have a channel reserved without actually using it to transfer data. This 
can cause a problem only if the channel has a high reserve percentage (from 80 to 100 
percent) and the corresponding activity for the channel is low (less than 20 percent). The 
exceptions are those channels that are dedicated to PPs such as DSD, PIP, and 1HP. 
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Channel Active 

TRACER maintains a channel active counter for each available channel and increments a 
counter whenever it detects that the channel is not inactive, as determined by an IJM PP 
instruction. 

System performance is affected most by disk channel activity. A percentage of from 10 to 30 
percent is considered normal. When this percentage reaches 35 to 40 percent, your system 
may experience performance degradation. High channel activity could be caused by the 
following factors. If you can scale down these problems, you may decrease channel activity 
and improve system performance; otherwise, you may need more disk controllers. 

• Do all the disk channels show similar activity levels? If not, examine the attributes you 
have described for each disk unit. For example, what units contain permanent files, 
rollout files, a copy of the system, and temporary files? You may have to redistribute 
the work load by changing attributes. Determine which files are busy and the devices 
on which they reside using the PFCAT utility. You may find that altering device masks 
and/or moving files will lower the channel activity. You are looking for an even 
percentage of work performed by each of the disk channels. 

The system selects file residency based on several factors. If the file is a permanent file, 
the system uses the device masks you have set for your family. If it is a temporary file 
or rollout file, the system looks at the attributes set for each device and selects the best 
candidate based on the following. 

- First, the system looks at the number of tracks available on each potential device. 
If any of the devices have fewer tracks available than the low space threshold set by 
the THRESHOLD command, those devices will no longer be candidates for selection 
unless all of the other potential devices are also below their threshold levels. 

— Second, the system picks (from the remaining candidates) the device with the least 
activity. 

• Are there an excessive number of rollouts? User jobs may be reaching the CM or CP 
time slice limits. Check your SERVICE parameters and examine the number of time 
slices reported in the statistical data area from CMR. The system may be rolling jobs in 
and out of the control points if your SERVICE limits are too small. By adjusting the 
limits, you should improve system performance. 

• Are large user jobs or subsystems rolling in or out? This can be determined by watching 
the DSD rollout status display (R). One large job can cause problems if it uses too many 
resources. Redesigning or rescheduling the job may help. 

• Examine the PROBE utility output. PROBE reports the PP programs that were loaded 
(program name, residency, and number of loads). Any program that is loading more 
than once per second, should be made central memory resident. If you are short of 
central memory, place these programs in extended memory. 
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Channel Requested 

TRACER maintains a channel requested counter for each available channel or concurrent 
channel and increments a counter whenever there is an outstanding request for that 
channel. TRACER uses the channel status table to determine the channel requested status. 

This counter tells you how often PP programs have requested a channel but were unable to 
reserve it because another PP program had it reserved. A normal count is from 20 to 50 
percent. The exceptions are those channels that are dedicated to PPs such as DSD, PIP, and 
1HP. 

This can be used for debugging purposes when developong your own PP programs that 
require channels. Be sure that you follow the rules governing channel dialog. 

Requests Pending 

TRACER maintains a request pending counter for each mass storage device available and 
increments a counter by the number of outstanding requests on that device when the 
sampling occurs. The MST provides this information. 

Ensure that the number of requests pending is evenly distributed between all units. If not, 
you may have to redistribute files (permanent, system, temporary, and rollout files) for the 
devices to obtain a more even distribution. Adding more disk units to a configuration will 
also aid in reducing the number of requests outstanding. 

Buffered I/O Lists 

TRACER maintains a counter for each type of buffered I/O buffer list (Empty, Data Written, 
Read, Write). The number of buffers assigned to each list is incremented based on the 
buffered I/O data tables. 

An average of 25 percent of the buffers on the Empty and Data Written lists is normal. The 
Write list should contain from 2 to 3 percent of the buffers, but a higher percentage is 
acceptable. The Read list is normal at from 65 to 75 percent. If there seems to be a shortage 
of Empty and Data Written buffers, you can add more extended memory for I/O buffer space. 

Buffered I/O Channel Busy 

TRACER maintains a PP driver busy counter for each buffered I/O channel and increments 
a counter whenever a data transfer associated with that channel is in progress. For 885-4x 
disks, the data transfer occurs through the low-speed port to ESM rather than the channel; 
only control and status information transfers over the channel. TRACER uses the buffered 
I/O channel control table to determine the PP driver busy status. 

The normal percentage is from 15 to 20 percent for a model 760 with two channels. This • 
percentage may be higher for machines with slower CPUs. 
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CPU Usage 



TRACER maintains a set of CPU usage counters for each CPU. There is a counter for each 
type of CPU use. 

Counter CPU Use 



IDLE CPU is not currently being used. 

PR MD FTN CPU is being used by CPUMTR for program-mode monitor functions. 

STOR MOVE CPU is being used by CPUMTR for storage move. 

FL VER CPU is being used by CPUMTR for field length verification. 

PSEUDO-PP CPU is being used by CPUMTR to process buffered I/O requests in the 
pseudo-PP. 

SUBSYSTEM CPU is being used by a subsystem. 

SYS ORG CPU is being used by a system origin job (subsystems are not considered 

system origin). 

USER CPU is being used by a user program. 

EI CPU is being used by EI, the environmental interface. This is a segment 

of native-mode CYBER 180 code which processes illegal CYBER 
170-mode instructions, and which performs communication between 
NOS and NOS/VE. 

VE SYSTEM CPU is being used by NOS/VE for a system task. 

VE USER CPU is being used by NOS/VE for a user job. 

Each time the CPU status is sampled (in words CPAL and CPAL+1 in CMR), TRACER 
increments one of the CPU usage counters. It determines which counter to update by 
investigating the control point area to which the CPU is assigned. 

Tune your system to get the most CPU usage for your users. Following are suggestions on 
how to do this. 

• If you run a mixture of jobs, such as interactive and batch jobs, set the limit of 
executing batch jobs to a number that minimally impacts interactive users with respect 
to central memory and control points. You may have to assign batch jobs a higher 
queue priority so they essentially will be locked into the control points. Since 
interactive jobs tend to use the CPU for short durations, the batch jobs will be there 
using up whatever CPU time is left from the interactive jobs. 

• On machines with big memories, it is usually advantageous to assign most of the 
memory to the users instead of using UEM as a rollout device. This helps in two ways: 
1) rolling jobs to disk usually takes less CPU overhead than rolling jobs to UEM; 2) 
with more memory for the users, NOS performs less storage moves. 

However, if you are rolling jobs to 887, 895, or 9853 disks and your system is 
CPU-saturated, you may want to rollout jobs to UEM and use the ENABLE,DDP 
ROLLOUT PATH entry in the IPRDECK. This will make rollout processing slower but 
should reduce system CPU usage. 

• If you run site-developed subsystems, examine the possibility of performing more of the 
work as disk activity rather than manipulating the data in central memory. 
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Subsystem CPU Usage 

Subsystem CPU usage is a further breakdown of subsystems of the SUBSYSTEM CPU 
usage data. TRACER maintains a CPU usage counter for every subsystem. Whenever the 
SUBSYSTEM CPU usage counter is incremented, TRACER also increments the appropriate 
subsystem CPU usage counter. 



Medium Loop Items 

The following paragraphs describe medium loop items. 

Medium Loop Samples 

TRACER increments the medium loop samples counter each time the medium loop items 
are sampled. 

CPS in W Status 

TRACER increments the control points in waiting (W) status counter whenever a control 
point is found in W status (determined by STSW word of control point area). TRACER 
scans all control points during each medium loop cycle. 

CPS in X Status 

TRACER increments the control points in periodic or automatic recall (X) status counter 
whenever it finds a control point in X status (determined by STSW word of control point 
area). TRACER scans all control points during each medium loop cycle. 

CPS in I Status 

TRACER increments the control points in automatic recall (I) status counter whenever a 
control point is found in I status (determined by STSW word of control point area). 
TRACER scans all control points during each medium loop cycle. 

Same Move Request 

TRACER increments the same move request counter every time the move request pending 
for the current medium loop cycle is the same as the previous medium loop cycle. Word 
CMCL of CMR is used to determine this status. 

Use this counter to determine if NOS is having trouble moving jobs in central memory. A 
value of from 5 to 10 percent is not unreasonable. A higher percentage indicates that you 
probably are short of memory. Examine the FL available counter. 

FL Available 

TRACER increments the FL available counter by the amount of available FL during the 
current medium loop cycle. Word ACML of CMR determines the available FL. 
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Compare this counter with the average FL in the rollout queue (FL in the rollout queue 
divided by the average number of jobs in the queue). On a busy system, the average amount 
of FL available should be less than that required for the average job in the rollout queue. 
You may need to consider any jobs that are in the rollout queue but are not schedulable, 
such as NAM supervisory applications (CS, NS, and NVF). On a system that is not heavily 
used, the FL available counter is of little value since there should always be memory 
available. 



User EM Available 

TRACEE increments the user extended memory available counter by the amount of 
available user extended memory FL during the current medium loop cycle. Word AECL of 
CMR determines the available user extended memory FL. 

Compare this number to the amount of extended memory at control points and rollout 
queues to determine if you have enough user extended memory. 



Noninteractive Jobs 

TRACER maintains a count of noninteractive jobs by monitoring the number of EJT entries 
with a connection status of NICS. 



Detached Jobs 

TRACER maintains a count of detached interactive jobs by monitoring the number of EJT 
entries with a connection status of DTCS. 



Online Jobs 

TRACER maintains a count of online jobs by monitoring the number of EJT entries with a 
connection status of OLCS. 



Preinitial Job Step 

TRACER maintains a count of preinitial jobs for each service class by monitoring the 
number of EJT entries with a job status of PRJS. A job is in this state after it has been 
assigned to an EJT entry but before it has been assigned to a control point for the first time. 



Executing 

TRACER maintains a count of executing jobs for each service class by monitoring the 
number of EJT entries with a job status of EXJS. 



Scheduler Rollout 

TRACER maintains a count of jobs rolled out by the job scheduler for each service class by 
monitoring the number of EJT entries with a job status of RO JS. 
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SCP Rollin 

TRACER maintains a count of jobs rolled in by system control point processing for each 
service class by monitoring the number of EJT entries with a job status of SIJS. 

SCP Rollout 

TRACER maintains a count of jobs rolled out by system control point processing for each 
service class by monitoring the number of EJT entries with a job status of SOJS. 

Timed I Event Rollout 

TRACER maintains a count of jobs in a timed/event rollout queue for each service class by 
monitoring the number of EJT entries with a job status of TOJS. 

Interactive Rollout 

TRACER maintains a count of jobs rolled out by interactive input/output processing for each 
service class by monitoring the number of EJT entries with a job status of IOJS. 

Disabled Rollout 

TRACER maintains a count of disabled jobs rolled out for each service class by monitoring 
the number of EJT entries with a job status of DOJS. 

Suspended Rollout 

TRACER maintains a count of suspended jobs rolled out for each service class by monitoring 
the number of EJT entries with a job status of SUJS. 

Rollout File Error 

TRACER maintains a count of jobs with rollout file errors for each service class by 
monitoring the number of EJT entries with a job status of ERJS. 

EJT Entries in Use 

TRACER maintains a count of the number of EJT entries in use for all jobs during the 
specified time interval. Each EJT entry is four central memory words long. If you are short 
of memory, you can gain some memory by decreasing the number of EJT entries. 

FL at Control Points 

TRACER maintains an FL at control point counter for each service class. When an active 
control point is found, the service class is determined and the appropriate counter is 
incremented by the amount of FL assigned to that control point (determined by FLSW of 
control point area). TRACER scans all control points during the medium loop cycle. 

Use this count to determine which service class of jobs is using the most memory. For 
example, if you have poor interactive job response and notice that the batch service class is 
using the most memory, it may help to restrict batch jobs to a smaller central memory time 
slice using the CM parameter of the SERVICE entry in the IPRDECK. 
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FL at Pseudo-control Points 

TRACER maintains an FL at pseudo-control point counter for each service class. When an 
active pseudo-control point is found, the service class is determined and the appropriate 
counter is incremented by the amount of FL assigned to that pseudo-control point 
(determined by FLSW of pseudo-control point area). TRACER scans all pseudo-control 
points during the medium loop cycle. 



FL in Rollout Queue 

TRACER maintains an FL in rollout queue counter for each service class. When a rollout 
file is found in the queue, and it is not assigned to a control point, the amount of FL it will 
require (determined from the EJT) when it is rolled into a control point is added to the 
appropriate counter. TRACER scans all EJT entries during the medium loop cycle. 

Use this count in conjunction with the FL available counter to determine if you have a 
central memory shortage. 



EM Memory at Control Points 

TRACER maintains an extended memory at control point counter for each service class. 
When an active control point is found, the service class is determined and the appropriate 
counter is incremented by the amount of extended memory assigned to that control point 
(determined by ECSW of control point area). TRACER scans all control points during the 
medium loop cycle. 

Use this count in conjunction with the user EM available counter and the EM in rollout 
queue counter to determine if you have an extended memory shortage. 



EM Memory at Pseudo-control Points 

Use this count in conjunction with the user EM available counter and the EM in rollout 
queue counter to determine if you have an extended memory shortage. 



EM in Rollout Queue 

TRACER maintains an extended memory in rollout queue counter for each service class. 
When a rollout file is found in the queue, and it is not assigned to a control point, the amount 
of extended memory FL it will require when rolled in (determined from the EJT) is added to 
the appropriate counter. TRACER scans all EJT entries during the medium loop cycle. 

Use this count in conjunction with the user EM available counter and the EM memory at 
CP counter to determine if you have an extended memory shortage. 



Subsystem FL 

TRACER maintains a subsystem FL counter for every possible subsystem. When a 
subsystem is found at a control point, the amount of FL assigned to that subsystem is added 
to the appropriate counter. TRACER scans all control points during the medium loop cycle. 
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Slow Loop Items 

The following paragraphs describe slow loop items. 

Slow Loop Samples 

TRACER increments the slow loop samples counter each time the slow loop items are 
sampled. 

IAF Users 

TRACER increments the IAF users counter by the number of users connected to IAF during 
the slow loop cycle. IAF must be active for this data to be collected. Word VANL of IAF FL 
determines the number of users. 

IAF Pots Allocated 

TRACER increments the pots allocated counter by the number of pots that are currently 
available for use, whether they are being used or not. Word VPAL of IAF FL determines the 
number of pots allocated. 

IAF Pots in Use 

TRACER increments the pots in use counter by the number of pots currently assigned to a 
connection. Word VPUL of IAF FL determines the number of pots in use. 

Queue Files Assigned 

TRACER maintains a count of the number of queued files assigned to control points by 
monitoring QFT entries. 

Input Files 

TRACER maintains a count of the number of input files for each service class by monitoring 
QFT entries. 

Print Files 

TRACER maintains a count of the number of print files for each service class by monitoring 
QFT entries. 

Punch Files 

TRACER maintains a count of the number of punch files for each service class by 
monitoring QFT entries. 

Other Queue Files 

TRACER maintains a count of the number of other queued files not assigned to control 
points for each service class by monitoring QFT entries. This includes any queued file that 
is not an input, print, or punch file. 
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QFT Entries in Use 



TRACER maintains a count of the number of QFT entries in use for all jobs during the 
specified time interval. Each QFT entry is four central memory words long. If you are short 
of memory, you can gain some memory by decreasing the number of QFT entries. 



Tape Drives in Use 

TRACER maintains two tape drives in use counters; one for 7-track and one for 9-track 
drives. A tape drive is considered to be in use if an EST entry indicates it is logically turned 
on, and it is assigned to a job. TRACER increments the appropriate counter for each drive 
found in use. 



Tracks Available 

TRACER maintains a tracks available counter for each mass storage equipment and adds 
the number of available tracks (tracks not currently assigned to a file) for a device to the 
appropriate counter for each mass storage device found in the EST. TRACER obtains this 
information from TDGL of the MST. 



CPPs Active 

TRACER increments the CPP active counter for each active CPP it finds when scanning the 
PP communication area. Disabled CPPs (those turned off at deadstart time) are not 
considered active. An active CPP is one that has a nonzero input register. 



ISHARED Table Changes 

TRACER maintains a count of the number of monitor function calls that force a table 
update in an ISHARED environment. 



ISHARED Device Updates 

TRACER maintains a count of the number of times the device-resident tables are updated 
in an ISHARED environment. 



ISHARED Seek Time 

TRACER monitors the ISHARED seek time by recording the total time spent reading the 
first sector during a table update sequence. 



ISHARED Updating Time 

TRACER monitors the ISHARED updating time by recording the total time spent updating 
tables and the maximum time and minimum time to update the tables for both single and 
simultaneous operations. 
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Statistical Summary 

The following paragraphs describe various statistics collected by TRACER. 

MTR Maximum Time 

TRACER reports the maximum time, in microseconds, that MTR waits for a CPU exchange 
to occur after being initiated by a monitor exchange jump (MXN). 

Direct Moves 

Tracer reports the number of direct storage moves of central memory or extended memory. 

Worst Case MTR Cycle Time 

TRACER reports the maximum time, in milliseconds, that it takes MTR to make a complete 
cycle; processing all PP output register requests and performing its other system functions. 

Missed Clock Updates 

TRACER reports the number of times MTR was not able to update the clock. 

EM Moves 

TRACER reports the number of storage moves of extended memory performed by CPUMTR. 

Central Memory Moves 

TRACER reports the number of storage moves of central memory performed by CPUMTR. 

Rollouts to MS 

TRACER reports the total number of jobs rolled out to mass storage by the job rollout 
routine (1RO). 

Pseudo-Rollouts 

TRACER reports the number of jobs rolled to a pseudo-control point. 

PCP Job Rollouts 

TRACER reports the number of pseudo-control point jobs rolled out to mass storage. 

Secondary Rollouts 

TRACER reports the number of jobs rolled out to secondary rollout devices by the job rollout 
routine (1RO). 
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Total Sectors Rolled 



TRACER reports the total number of sectors of mass storage used by the job rollout routine 
(1RO) for rollouts. 

Secondary Sec Rolled to MS 

TRACER reports the number of sectors of mass storage used by the job rollout routine 
(1RO) for rollouts to secondary rollout devices. 

Rollouts I User Limits 

TRACER reports the number of jobs rolled out due to a time limit or SRU limit detected by 
the job scheduler (1SJ). 

Time Slices 

TRACER reports the number of jobs whose scheduling is set to the lower bound for its 
service class due to an expired CM time slice. 

PP Priority Exchanges 

TRACER reports the number of priority exchange requests issued by PPs and CPPs. A 
priority exchange is issued after three unsuccessful attempts to perform a monitor exchange 
jump (MXN). 

No Comm Buffer Avail 

TRACER reports the number of times CPUMTR could not use a communications buffer 
because all buffers were full. 

No PCP Available 

TRACER reports the number of times a pseudo-control point was not available. 

EJT Scans 

TRACER reports the number of times the job scheduler (1SJ) scans the executing job table 
(EJT) to schedule a job to a control point. 

Schedulable Jobs 

TRACER reports the total number of schedulable jobs. This is determined by adding the 
number of schedulable jobs in the EJT on each EJT scan. 

Jobs Preempted 

TRACER reports the number of jobs that were rolled out so that the job scheduler (1SJ) 
could schedule a higher priority job. 

Jobs Scheduled 

TRACER reports the number of jobs scheduled to a control point. 
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Scheduled No Constraints 

TRACER reports the number of jobs scheduled with no service class, central memory, or 
extended memory constraints imposed. 

Insufficient CM Scans 

TRACER reports the number of EJT scans for which a schedulable job was found, but could 
not be scheduled due to insufficient central memory. 

Insufficient EM Scans 

TRACER reports the number of EJT scans for which a schedulable job was found, but could 
not be scheduled due to insufficient extended memory. 

No Control Point Scans 

TRACER reports the number of EJT scans for which a schedulable job was found, but could 
not be scheduled because all control points were busy. 
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PROBE Utility 

The PROBE utility measures the following: 

Number of times a PP or CPP routine was loaded. 

Number of CIO RA+1 requests by function number. 

Number of PP requests to CPUMTR by function number. 

Number of MTR requests to CPUMTR by function number. 

Statistical data accumulated in CMR includes items such as number of sectors rolled, 
number of rollouts, and number of pseudo-rollouts. 

Input/output statistics for 885-42 and 895 Disk Storage Subsystems showing the 
number of sectors transferred and control buffer tables transferred. 

PROBE data gathering is selectable at deadstart time by an IPRDECK entry. SYSEDIT 
resets the PROBE data tables to zeros. 

The PROBE utility generates a report from the data collected by the system. PROBE 
analyzes data either from system tables or from a binary file containing data from a 
previous PROBE run. An IPRDECK entry ENABLE,PROBE must be specified at deadstart 
time to allow the system to collect the data. (Refer to section 3, Deadstart Decks, for more 
information.) 

Format: 

PROBE ,p 1 ,p 2 p n . 

Pj Description 

B=readfile 
L=outfile 
L=0 
LO=opt 



Binary file to be read. Default is STATS. 

Report file. Default is OUTPUT. 

No report is to be generated. 

Sort option for PP program load information. Default is F. 

opt Description 

A Sort data in alphabetic order. 

F Sort data by frequency of loads. 

R Sort data by location and frequency of loads. 
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Pi 



OP=opt 



Description 



Processing option. Default is P. 
opt Description 



R 



Perform R option functions and clear system tables after they are 

read. 

Generate report from binary file specified by the B parameter. 

This binary file has been created by a previous PROBE run with 

OP=C or OP=R specified. 

Read system tables, and write binary file and report file as 
specified. 



P=writefile Binary file to be written. Default is STATS. 

P=0 No binary file is to be written. 

R Rewind binary files before and after operation. Default is no rewind. 



NOTE 



The file names must be unique. If you specify OP=C or OP=R, then you may not specify P=0. 

Figure 21-2 is an example of the PROBE output file format. 

When looking at the PP program load information reported on the PROBE output, check to 
see if it meets these suggested performance requirements: 

• PP programs called at least once every second should be central memory resident. 

• PP programs called at least once every 2 seconds are good candidates for alternate 
residency using extended memory. 

• PP programs called every 3 seconds or less should be disk resident. 

You can change a PP program's residency using the SYSEDIT command (refer to section 19, 
SYSEDIT). 
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PROBE VERSION 1.0. 






yy/mm/dd. hh.mm.ss 


PAGE 1 


PROBE 


VERSION 


1.0 


yy/mm/dd. 


hh.mm.ss. 




START 


OF SAMPLE INTERVAL 


yy/mm/dd. 


hh.mm. ss. 




END OF 


SAMPLE 


INTERVAL 


yy/mm/dd. 


hh.xnm. ss. 




MONITOR REQUESTS 












PROGRAM MODE 


MONITOR 


MODE 








CPUO 


CPUO 


CPU1 




CHGM< 


21) 













HNGM( 


22) 















23) 













AFAM( 


24) 





7177 







DLKM( 


25) 













DTKM( 


26) 


131214 


189955 







RTCM( 


27) 


129969 


129969 







STBM( 


30) 





121555 







VMSM( 


31) 


9108 


9108 







ACTM( 


32) 


1133 


20059 







BFMM( 


33) 













CKSM( 


34) 


435 


435 







CSTM( 


35) 


34405 


34670 







ECSM( 


36) 













PIOM( 


37) 













RDCM( 


40) 


3170 


3170 







ABTM( 


41) 





76 







BIOM( 


42) 













BMIM( 


43) 













CCAM( 


44) 





77321 







CEPM( 


45) 





832 







CPRM( 


46) 













DCPM( 


47) 





25696 







DEQM( 


50) 





41425 







DFMM( 


51) 





36827 







DPPM( 


52) 





1108876 







EATM( 


53) 





48694 







JACM( 


54) 





59846 







LDAMI 


55) 





844946 







LMSM( 


56) 













MTRM< 


57) 





2495 







PLFM( 


60) 





76738 







RCLM1 


61) 





447037 







RCPM< 


62) 





1110 







RECM( 


63) 





46638 







REQM( 


64) 





41426 







RJSM{ 


65) 





675 







RLMM{ 


66) 





30666 







ROCM( 


67) 





15092 







RPNM< 


70) 













RPPM( 


71) 





106311 







RSJM( 


72) 





15481 







SCDM( 


73) 





62387 







SFBM( 


74) 





70802 







SJCM( 


75) 





22237 







SPLM( 


76) 





1358228 







TDAM( 


77) 





17566 







TGPM( 


100) 





11532 







TIOM( 


101) 





21228 







TSEMf 


102) 





37099 







UADMf 


103) 





583735 







UTEM( 


104) 





1473766 








Figure 21-2. Example of PROBE Output (Continued) 
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PROBE VERSION 1.0 




VFLMU05) 





VFPMU06) 





VSAMU07) 





(110) 





SUBTOTAL 




TOTAL 


309434 


MTR REQUESTS 






CPUO 


ARTF( 1) 


27487 


IARFf 2) 





CSLF( 3) 


23220 


RCLF( 4) 


6134559 


MFLFf 5) 


66297 


SCSF( 6) 





SMSF( 7) 





CMSF(IO) 





PRQF(ll) 


41638 


ACSF ( 12 ) 


93425 


PCXFU3) 





ARMF(14) 





(15) 





MFEFU6) 





SUBTOTAL 


6386626 


TOTAL 


6386626 



PROGRAM MODE 



HSTF( 1) 
PDMF( 2) 
PMRF( 3) 
MECF( 4) 
TOTAL 



CPUO 

23220 







23220 



CPU1 



yy/mm/dd. hh.mm.ss. PAGE 









14518 





13180 











7230584 







7230584 



MTR PERFORMANCE PARAMETERS 
WORST CASE *MXN* TIME = 
WORST CASE CYCLE TIME = 
MISSED CLOCK UPDATES = 

CPUMTR PERFORMANCE PARAMETERS 
EM STORAGE MOVES = 
CM STORAGE MOVES = 
DIRECT MOVES = 

COMMUNICATIONS BUFFER NOT AVAILABLE = 
PP PRIORITY EXCHANGE REQUESTS = 
PSEUDO-CONTROL POINT NOT AVAILABLE 

1RO PERFORMANCE PARAMETERS 
NUMBER OF ROLLOUTS = 
PSEUDO-ROLLOUTS = 
PSEUDO-CONTROL POINT ROLLOUTS = 
ROLLOUTS TO SECONDARY DEVICES = 
NUMBER OF SECTORS ROLLED = 
SECTORS ROLLED TO SECONDARY DEVICES = 



751 
6 
2 




24173 
20540 




351 



18393 

4000 

1000 



2918049 





Figure 21-2. Example of PROBE Output (Continued) 
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PROBE VERSION 1.0. 








yy/mm/dd. hh.mnt.ss 


PAGE 3 


IS J PERFORMANCE 


PARAMETERS 








EJT SCANS = 








76193 




SCHEDULABLE JOBS= 






21917 




JOBS PREEMPTED 


= 






95 




JOBS SCHEDDLED 


= 






17866 




JOBS SCHEDULED 


NO 


CONSTRAINTS = 







EJT SCANS WITH 


INSUFFICIENT 


CM = 


130 




EJT SCANS WITH 


INSUFFICIENT 


EM = 







EJT SCANS WITH 


NO 


CONTROL POINT = 


2 




ROLLOUTS FOR RESOURCE LIMITS = 


1 




TIME SLICES = 








460 




CIO REQUESTS 












FUNCTION 




CALLS 


FUNCTION 


CALLS 




RPHR(OOO) 




3015 


READ(OIO) 


154978 




WRITE (014) 




83438 


READSKP(020) 


4907 




WRITER (024) 




53751 


WRITEF(034) 


5237 




BKSPI040) 




465 


REWIND (050) 


55857 




**"(54) 




128 


UNLOAD(O60) 


459 




RETURN (070) 




30345 


OPEN (100) 


2200 




OPEN (104) 




2643 


EVICT (114) 


1653 




OPEN (120) 




2602 


CLOSE (130) 


1356 




OPEN (140) 




753 


OPEN (144) 


4885 




CLOSE (150) 




582 


OPEN(160) 


543 




CLOSE (170) 




5339 


CL0SEU74) 


465 




READCW1200) 




15476 


WRITECW(204) 


7361 




READLS(210) 




1235 


REWRITE (214) 


13111 




REWRITER(224| 




11907 


RPHRLS(230) 


25137 




SKIPF(240) 




9784 


READNS(250) 


400 




READEK600) 




5893 


SKIPB1640) 


4386 




TOTAL CIO FUNCTIONS 


PROCESSED 


510291 







Figure 21-2. Example of PROBE Output (Continued) 
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PROBE VERSION 1. 


3. 




PPU PROGRAM 


LOADS 




NAME 


LOC 


LOADS 


NAME 


CPM 


CMR 


605181 


PIP 


IMS 


CMR 


460275 


PNC 


4MB 


CMR 


243588 


SBP 


4MD 


CMR 


169670 


SLL 


4ME 


CMR 


155651 


SMP 


QAC 


CMR 


83410 


TMG 


3Q3 


CMR 


83372 


VEJ 


1SJ 


CMR 


73838 


VER 


3AE 


CMR 


70341 


WRM 


LFM 


CMR 


69611 


XIS 


1AJ 


CMR 


47141 


X26 


3 LB 


CMR 


46964 


OCI 


TCS 


CMR 


46406 


OIP 


3QU 


DSK 


46381 


OMC 


LDR 


CMR 


43575 


OMD 


IMA 


CMR 


39939 


OSD 


OBF 


CMR 


37181 


OSI 


3QS 


CMR 


36988 


OTD 


4MC 


CMR 


31223 


1FA 


3NW 


CMR 


29968 


1HP 


110 


CMR 


27405 


IIS 


NDR 


CMR 


26489 


1KB 


RHH 


DSK 


25371 


1LC 


1MT 


CMR 


24435 


1LT 


3ME 


CMR 


24435 


IMF 


ODF 


CMR 


24317 


1MR 


3MF 


CMR 


23257 


IPC 


3CD 


CMR 


21678 


1PD 


3AF 


CMR 


19990 


1PL 


3MJ 


CMR 


19709 


1PR 


QFM 


DSK 


19637 


1RM 


RPV 


CMR 


18598 


1RP 


1R0 


CMR 


18282 


1R0 


1RI 


CMR 


18262 


1TM 


1MI 


CMR 


14294 


1TN 



1R0 


CMR 


18282 


1RI 


CMR 


18262 


1MI 


CMR 


14294 


3LD 


CMR 


12765 


SFM 


CMR 


12584 


3SX 


CMR 


10536 


STD 


DSK 


9223 


4SD 


DSK 


9222 


3AD 


DSK 


8614 


2MA 


DSK 


8501 


TLX 


CMR 


8444 


1DD 


CMR 


7995 


4MF 


CMR 


7600 


3RP 


CMR 


7357 


3RH 


CMR 


7342 


PFM 


CMR 


6961 


3 PA 


CMR 


5122 


3LC 


CMR 


5085 


3AI 


CMR 


4722 



LOC 


LOADS 


DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





CMR 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





CMR 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 





DSK 






yy/mm/dd. hh.mm.ss. PAGE 



Figure 21-2. Example of PROBE Output (Continued) 



60459300 U 



Tracer/Probe Utilities 21-41 



PROBE Utility 



PROBE VERSION 1.0 








yy/mm/dd. 


hh.mnt.ss. PAGE 5 


3LE 


CMR 


4024 


2MF 


DSK 







3 PC 


CMR 


3960 


2MN 


DSK 







3QD 


DSK 


3959 


2MR 


DSK 







LDQ 


CMR 


3790 


2MZ 


DSK 







3PD 


CMR 


3619 


2NT 


DSK 







3QA 


DSK 


2800 


2NU 


DSK 







3CR 


CMR 


2749 


2PT 


DSK 







3CS 


CMR 


2748 


2PV 


DSK 







1TO 


CMR 


2296 


2PX 


DSK 







2 TO 


CMR 


2203 


2RP 


DSK 







3PE 


CMR 


2080 


2RU 


DSK 







OAV 


CMR 


1887 


2 SB 


DSK 







1TA 


DSK 


1867 


2SC 


DSK 







3CB 


CMR 


1822 


2SE 


DSK 







1CK 


DSK 


1699 


2SF 


DSK 







3 PR 


CMR 


1682 


2SG 


DSK 







3MQ 


CMR 


1670 


2SI 


DSK 







3CC 


DSK 


1643 


2TM 


DSK 







3SV 


DSK 


1598 


2TN 


DSK 







3PN 


CMR 


1489 


3AG 


DSK 







ORP 


CMR 


1325 


3AH 


CMR 







LDD 


CMR 


1301 


3BB 


DSK 







3TC 


DSK 


1200 


3BC 


DSK 







OFA 


CMR 


1162 


3BD 


DSK 







DSP 


DSK 


1161 


3BE 


DSK 







3DB 


DSK 


1120 


3BF 


DSK 







ODQ 


DSK 


1086 


3CA 


DSK 







3RG 


DSK 


1029 


3CV 


DSK 







2NW 


DSK 


995 


3FB 


DSK 







3MI 


CMR 


981 


3IC 


DSK 







OAU 


DSK 


947 


3 ID 


DSK 







3AK 


DSK 


941 


3IE 


DSK 







3AA 


DSK 


934 


3IM 


DSK 







3PQ 


CMR 


923 


3IN 


DSK 







2NR 


DSK 


922 


310 


DSK 







3AJ 


DSK 


918 


3IP 


DSK 







3QW 


DSK 


904 


3IQ 


DSK 







3QX 


DSK 


903 


3KA 


DSK 







3Q0 


DSK 


903 


3KB 


DSK 







3PH 


CMR 


791 


3KC 


DSK 







CVL 


DSK 


747 


3LA 


DSK 







3QC 


DSK 


685 


3MA 


DSK 







SFP 


CMR 


605 


3MB 


DSK 







3AB 


DSK 


596 


3MD 


DSK 







IDS 


CMR 


521 


3MK 


CMR 







3DA 


DSK 


491 


3MM 


DSK 







1ML 


DSK 


490 


3MR 


CMR 







3TE 


DSK 


480 


3MU 


DSK 







3PI 


DSK 


479 


3 PM 


DSK 







1DL 


CMR 


454 


3PP 


DSK 







CMS 


DSK 


429 


3 OR 


DSK 







4DB 


DSK 


426 


3Q1 


DSK 







4DD 


DSK 


426 


3RF 


DSK 







3SA 


DSK 


425 


3RU 


DSK 







3MO 


CMR 


383 


3SU 


DSK 







3NM 


DSK 


382 


3SZ 


DSK 







3ML 


DSK 


354 


3TA 


DSK 







3MH 


DSK 


350 


4DF 


DSK 








Figure 21-2. Example of PROBE Output (Continued) 
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3PF 


CMR 


348 


2MD 


DSK 


338 


4MA 


CMR 


313 


OVJ 


DSK 


310 


ovu 


DSK 


310 


3PK 


DSK 


245 


3MC 


CMR 


237 


3AL 


DSK 


235 


2MC 


DSK 


216 


9AA 


DSK 


215 


SSH 


DSK 


210 


3MG 


DSK 


193 


3 TB 


DSK 


188 


PFU 


DSK 


177 


9EA 


DSK 


168 


ORP 


DSK 


163 


2SD 


DSK 


141 


3MT 


DSK 


138 


2NS 


DSK 


136 


3MP 


CMR 


133 


3PB 


DSK 


129 


3PJ 


DSK 


126 


3AM 


DSK 


91 


9BA 


DSK 


83 


3MN 


DSK 


82 


ORT 


DSK 


74 


3MS 


DSK 


67 


2NQ 


DSK 


63 


T76 


DSK 


58 


6DI 


CMR 


58 


OPT 


CMR 


51 


QAP 


DSK 


48 


NLD 


DSK 


46 


3 DC 


DSK 


36 


3 FA 


DSK 


35 


3Q2 


DSK 


32 


DIS 


DSK 


29 


3BA 


DSK 


24 


3BG 


DSK 


24 


3IA 


DSK 


24 


3 IB 


DSK 


24 


5IE 


DSK 


24 


3QB 


DSK 


22 


1CD 


DSK 


21 


3PL 


DSK 


19 


3AC 


DSK 


15 


2DA 


DSK 


13 


2SA 


DSK 


13 


7CI 


CMR 


13 


7DI 


CMR 


13 


7EI 


CMR 


13 


7EL 


CMR 


13 


7EM 


CMR 


13 


7EN 


CMR 


13 


7E0 


CMR 


13 


7EP 


CMR 


13 


7SI 


CMR 


13 


4HH 


DSK 


12 
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4DI 


DSK 


4DJ 


DSK 


4DK 


DSK 


4DZ 


DSK 


4IM 


DSK 


410 


DSK 


4IP 


DSK 


4IQ 


DSK 


4KB 


DSK 


4KC 


DSK 


4KD 


DSK 


4MG 


DSK 


4NB 


DSK 


4NC 


DSK 


4NM 


DSK 


4RA 


DSK 


4RB 


DSK 


4RC 


DSK 


4RD 


DSK 


4RE 


DSK 


4RF 


DSK 


4RG 


DSK 


5BA 


DSK 


5BB 


DSK 


5BC 


DSK 


5BD 


DSK 


5CU 


DSK 


5CV 


DSK 


5D1 


DSK 


5D2 


DSK 


5D3 


DSK 


5FF 


DSK 


5FH 


DSK 


5IA 


DSK 


5IC 


DSK 


5 ID 


DSK 


5IG 


DSK 


5IH 


DSK 


5LC 


DSK 


5LL. 


DSK 


5MA 


DSK 


5MB 


DSK 


5MC 


DSK 


5MD 


DSK 


5ME 


DSK 


5MG 


DSK 


5MR 


DSK 


5MS 


DSK 


5MT 


DSK 


5MU 


DSK 


5MW 


DSK 


5SE 


DSK 


5SU 


DSK 


5SV 


DSK 


5S1 


DSK 


5S2 


DSK 


5XA 


DSK 


5XB 


DSK 

























































































































Figure 21-2. Example of PROBE Output (Continued) 
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PROBE Utility 



PROBE VERSION 1.0. 




IMS 


DSK 


10 


3PG 


DSK 


10 


3QY 


DSK 


9 


3QZ 


DSK 


9 


2SH 


DSK 


8 


3CE 


DSK 


8 


OPI 


DSK 


7 


1MB 


DSK 


7 


IMP 


CMR 


7 


2DB 


DSK 


6 


3DD 


DSK 


6 


4DA 


DSK 


6 


4DC 


DSK 


6 


4DG 


DSK 


6 


026 


DSK 


5 


9GA 


DSK 


5 


3RI 


DSK 


4 


2NX 


DSK 


3 


2NY 


DSK 


3 


3AN 


DSK 


3 


3PO 


DSK 


3 


3QT 


DSK 


3 


3QV 


DSK 


3 


7EQ 


CMR 


3 


7ES 


CMR 


3 


OST 


DSK 


2 


3SY 


DSK 


2 


OTI 


DSK 


1 


OTJ 


DSK 


1 


3CK 


DSK 


1 


3RJ 


DSK 


1 


3SW 


DSK 


1 


3TD 


DSK 


1 


ADC 


DSK 





BAT 


DSK 





CPD 


DSK 





CUX 


DSK 





DDF 


DSK 





DOG 


DSK 





DS1 


DSK 





ELM 


DSK 





EYE 


DSK 





FDP 


DSK 





HFM 


DSK 





LIF 


DSK 





MDD 


DSK 





MLD 


DSK 





MP3 


DSK 





PIM 


DSK 
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5XC 


DSK 


5XD 


DSK 


5XE 


DSK 


5XF 


DSK 


5XG 


DSK 


541 


DSK 


55X 


DSK 


56X 


DSK 


57X 


DSK 


53F 


DSK 


58H 


DSK 


58X 


DSK 


7ER 


CMR 


7FI 


CMR 


7GI 


CMR 


7HI 


CMR 


711 


CMR 


7JI 


CMR 


7KI 


CMR 


7LI 


CMR 


7SE 


CMR 


7WI 


CMR 


8XA 


DSK 


8XB 


DSK 


8XC 


DSK 


9CA 


CMR 


9CB 


CMR 


9CC 


CMR 


9 CD 


CMR 


9CE 


CMR 


9CF 


CMR 


9CG 


CMR 


9CH 


CMR 


9CI 


CMR 


9CJ 


CMR 


9CK 


CMR 


9CL 


CMR 


9CM 


CMR 


9CN 


CMR 


9 CO 


CMR 


9CP 


CMR 


9CQ 


CMR 


9CR 


CMR 


9CS 


CMR 


9JN 


DSK 


9VA 


DSK 


9WA 


DSK 



NUMBER OF ASR PROGRAMS = 

NUMBER OF CMR PROGRAMS = 123 

NUMBER OF DSK PROGRAMS = 313 

NUMBER OF PLD ENTRIES = 436 



Figure 21-2. Example of PROBE Output (Continued) 
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PROBE VERSION 1.0. 

I/O STATISTICS FOR 
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DB006: 



SECTORS 


CBT-S 






ANSFERRED 


TRANSFERRED 


READS 


WRITES 


1 


1-40B 





1 


2-3 


41B-140B 





23 


4-7 


141B-340B 








10B-17B 


341B-740B 








20B-37B 


741B-1740B 








40B-77B 


1741B-3740B 








100B-177B 


3741B-7740B 








20 OB-MORE 


7741B-MORE 









I/O STATISTICS FOR DB007: 



SECTORS 


CBT-S 




TRANSFERRED 


TRANSFERRED 


READS 


1 


1-40B 


19 


2-3 


41B-140B 


4 


4-7 


141B-340B 





10B-17B 


341B-740B 





20B-37B 


741B-1740B 





40B-77B 


1741B-3740B 





100B-177B 


3741B-7740B 





20 OB-MORE 


7741B-M0RE 






TOTALS 



I/O STATISTICS FOR DB010: 



SECTORS 

TRANSFERRED 

1 

2-3 

4-7 

10B-17B 

20B-37B 

40B-77B 

100B-177B 

200B-MORE 



23 



WRITES 
1 

1 

2 







CBT-S 






TRANSFERRED 


READS 


WRITES 


1-40B 





1 


41B-140B 








141B-340B 








341B-740B 





3 


741B-1740B 








1741B-3740B 








3741B-7740B 








7741B-MORE 









TOTALS 



Figure 21-2. Example of PROBE Output 
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Cartridge Tape Subsystem (CTS) and 
Automated Cartridge Subsystem (ACS) 22 

Both the Control Data 5680 Cartridge Tape Subsystem (CTS) and the Control Data 5744 
Automated Cartridge Subsystem (ACS) consist of hardware and software that allow reading 
and writing of IBM 3480-compatible cartridge tapes. 

In CTS, operators load and unload the cartridges on the tape units. ACS has additional 
hardware and software that robotically handles the cartridges. Once the cartridges are 
loaded into an ACS storage module, the ACS robot can perform all the conventional tape 
handling operations without operator assistance: tape retrieval and mounting, dismounting, 
and storage of tape volumes. The operator can also manually add or remove cartridges to 
and from the ACS storage module. 

Use of CTS and ACS is transparent to users; user requests for files stored on cartridge 
tapes are identical to requests for files on other types of tapes, except users specify a 
different density (CE for CTS tapes and AE for ACS tapes) and/or device type (CT for CTS 
tapes and AT for ACS tapes). 

CTS and ACS operate on Control Data CYBER 180 models 835 through 995 and require the 
Control Data CDCNET communications network. 

The next subsections describe: 

CTS components and configurations 

ACS components and configurations 

Cross-coupling controllers for CTS and ACS 

Configuration requirements and constraints for CTS and ACS 

Performance considerations for CTS and ACS 

Maintenance for CTS and ACS 

Cartridge Tape Subsystem 

The Cartridge Tape Subsystem (CTS) reads and writes IBM 3480-compatible cartridge 
tapes. CTS provides increased recording capacity and speed over that of reel tape units and 
is fully compatible with the optional Tape Management System (TMS). 

CTS Components 

The basic components of CTS are: 

• CYBER Channel Couplers (CCCs) that connect the mainframe(s) to Federal 
Information Processing Standard (FIPS) channels on cartridge tape controllers. 

• One or more 5680 cartridge tape controllers (also called control units). 

• One or more 5682 cartridge tape cabinets (also called cartridge drives). 

• Two or four tape units (also called tape transports) in each 5682 cartridge tape cabinet. 

• Operational and control software under NOS. 
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Cartridge Tape Subsystem 



NOS and other operating systems can share CTS; each operating system, however, must 
have a separate, dedicated controller and tape unit(s). 

You can purchase additional hardware to cross-couple CTS controllers; refer to 
Cross-Coupled Controllers for CTS and ACS. You can also purchase hardware and software 
to upgrade CTS to ACS. 

Table 22-1 lists and describes the functions of the CTS hardware components as well as the 
maximum CTS configuration. 

Table 22-1. CTS Hardware 



Hardware 
Component 



Cartridge 



5682-lx cartridge tape 
cabinet 



5680-lx cartridge tape 
controller 



Description 



Plastic housing enclosing magnetic tape on which data is 
stored. This cartridge is IBM 3480-compatible; it has a density 
of 38,000 cpi and a storage capacity of approximately 130 
megabytes when recorded in I format and 220 megabytes when 
recorded in LI format. 

Cabinet containing cartridge tape units. The 5682-12 cabinet 
contains two tape units; the 5682-14 cabinet contains four tape 
units. The tape units can be operated concurrently. A 
maximum of 16 tape units (four cabinets) can be configured for 
CTS. 

Controller for the tape units in the 5682-lx cabinet. There are 
four types of controllers: 5680-11, 5680-12, 5680-13, and 
5680-14. The last digit indicates how many FIPS channels in 
the controller can be used. 

A controller can simultaneously position tapes on four tape 
units, but can transfer data to or from only one tape at a time. 

A controller contains a 1-megabyte data buffer to maximize 
transfer rates. This buffer is divided into four 256-kilobyte unit 
buffers so that I/O can be performed simultaneously on four 
units without reusing a buffer. Attempts to simultaneously 
perform I/O on more than four units results in performance 
degradation. 

A controller can be connected to a maximum of two tape 
cabinets. A maximum of eight controllers can be configured for 
CTS. 



CTS Configuration 

The minimum CTS n (as shown in figure 22-1) consists of: 

• One NIO channel to the CCC 

• One cartridge tape controller 

• One cartridge tape cabinet containing two tape units 

After you install the CTS hardware, you must modify the EQPDECK and IPRDECK to 
reflect the CTS configuration: 
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Create EST entries for the CTS tape units in the EQPDECK 

Decide whether CTS is your site's default tape device type. If it is, enter in the 
IPRDECK: 

TDTY=CT . 



CYBER 
Host 



NOS 



CH1 



CYBER 
Channel 
Coupler 



FIP|FIP FFjnp" 



Cartridge 

Tape 
Controller 



Tape Unit (UN=0) 



Tape Unit (UN=1) 



06556M 



Figure 22-1. CTS Minimum Configuration 

EQPDECK and IPRDECK entries are described in section 3, Deadstart Decks. 
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Cartridge Tape Subsystem 

For the minimum configuration shown in figure 22-1, you could enter the following 
EQPDECK entry to define the two tape units: 

EQ60=CT-2 , ST=ON, CH=1 , UN=0 . 

For the preceding entry, NOS generates the EST entries: 

EQ60=CT, ST=ON, CH=1 , UN=0 . 
EQ61=CT, ST=ON, CH=1 , UN=1 . 

Dual-State CTS Configurations 

For dual-state mainframes, you can configure a fixed number of units to each operating 
system, or you can configure the units so that you can change unit assignments from one 
operating system to the other. Do the latter with caution, because it is possible to 
accidentally assign one unit to both operating systems. 

An example of a fixed number of CTS units assigned to dual-state partners is shown in 
figure 22-2. The following EQPDECK entry defines the two units to which NOS has 
exclusive access; do not define the tape units that NOS/VE (or another mainframe) uses. 

EQ62=CT-2 , ST=ON, CH=1 ,UN=2 . 

For the preceding entries, NOS generates the EST entries: 

EQ62=CT , ST=ON , CH=1 , UN=2 . 
EQ63=CT, ST=ON, CH=1 , UN=3 . 



















08556M 


•— 


CYBER 
Host 


—v 


NOS | NOS/VE 






Cl- 


11 






1 


CH2 




CYBER 
Channel 
Coupler 




CYBER 
Channel 
Coupler 
















F!P|FIP 


FIP|FIP 




RP|RP 


FIPjFIP 


Cartridge 

Tape 
Controller 


Cartridge 

Tape 
Controler 
















v 


Tape Unit (UN-0) 




Tape Unit (UN=1) 




Tape Unit (UN=2) 


Tape Unit (UN-3) 















Figure 22-2. Dual-State Fixed Configuration for CTS 

An example of configuring all CTS units to both NOS and NOS/VE is shown in figure 22-3. 
The following EQPDECK entries define the four units, assign a status of OFF to units and 
1, and assign status of ON to units 2 and 3: 



22-4 NOS Version 2 Analysis Handbook 



60459300 U 



Cartridge Tape Subsystem 



EQ60=CT-2 , ST=DOWN, CH=1 , DN=0 . 
EQ62=CT-2 , ST=ON, CH=1 , UN=2 . 

For the preceding entries, NOS generates the EST entries: 

EQ60=CT, ST=DOWN, CH=1 , UN=0 . 
EQ61=CT, ST=DOWN, CH=1 , UN=1 . 
EQ62=CT, ST=ON, CH=1 , UN=2 . 
EQ63=CT , ST=ON, CH=1 , UN=3 . 

Similarly, all four units must be denned on NOS/VE, but the status of units and 1 must 
be ON and the status of units 2 and 3 must be OFF. 



















06584W 


•— 


CYBER 
Host 


—v 


NOS | NOS/VE 






a 


11 








CH2 




CYBER 
Channel 
Coupler 




CYBER 
Channel 
Coupler 
















FIP |RP 


RPjRP 




RP|RP 


RP|RP 


Cartridge 

Tape 
Controller 


Cartridge 

Tape 
Controller 
















>_ 


Tape Unit (UN=0) 




Tape Unit (UN-1) 


Tape Unit (UN-2) 


Tape Unit (UN-3) 

















Figure 22-3. Dual-State Flexible Configuration for CTS 

As workload requirements change, you can logically move CTS units between NOS and 
NOS/VE. To move a unit from NOS to NOS/VE, enter the DOWN,EQ=nn DSD command on 
NOS and the CHANGE_ELEMENT_STATE subcommand of the Logical Configuration 
Utility on NOS/VE. Conversely, to move unit from NOS/VE to NOS, enter the 
CHANGE_ELEMENT_STATE subcommand on NOS/VE and the ON,EQ=nn DSD command 
on NOS. 

NOTE 

Be sure that each unit is always assigned to only one operating system. Otherwise, tapes 
may be incorrectly read and written. 



For an example of cross-coupled controllers, refer to Cross-Coupled Controllers for CTS and 
ACS. 
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Automated Cartridge Subsystem 

The Automated Cartridge Subsystem (ACS) is an integrated hardware and software 
package for robotically handling IBM 3480-compatible cartridge tapes. ACS provides for the 
automated retrieval, mounting, dismounting, and storage of tape volumes and is capable of 
unattended operations. Operators, of course, can manually add and remove cartridges from 
ACS and can enter a variety of UNIX 1 operator commands and utility functions at the ACS 
workstation. 

To use ACS, your site must install and activate the Tape Management System (TMS). TMS 
provides the tape security for labeled and unlabeled cartridge tapes. To verify that the 
correct tape is mounted and that the user has permission to access the tape, NOS compares 
the cartridge's external VSN (the bar-coded identification on the edge of the cartridge) and 
internal VSN with the VSNs specified on the request; if the tape is unlabeled, only the 
external VSNs are compared. 

TMS scratch tapes in ACS must have matching external and internal VSNs; the internal 
VSN should be written in ASCII mode and have blank volume and file accessibility fields 
(the BLANK utility's default values). 

To read ACS tapes without using TMS, initiate a system origin job and specify TO=F on the 
LABEL command. 



ACS Components 

The basic components of ACS are: 

• ACS hardware manufactured by Storage Technology Corporation (StorageTek). Its 
hallmark is a robotic unit that reliably manipulates tape cartridges within silo-shaped 
storage modules called library storage modules (LSM). 

Sun Workstation 2 and associated software. 

CYBER Channel Couplers (CCC) that connect the mainframe(s) to Federal Information 
Processing Standard (FIPS) channels on cartridge tape controllers. 

One or more 5680 cartridge tape controllers (also called control units). 

One or more 5682 cartridge tape cabinets (also called cartridge drives). 

Two or four tape units (also called tape transports) in each 5682 cartridge tape cabinet. 

Operational and control software under NOS. 

You can purchase additional hardware to cross-couple ACS controllers; refer to 
Cross-Coupled Controllers for CTS and ACS. 

NOS and other operating systems can share ACS; each operating system must have a 
separate, dedicated controller and tape units. 

Table 22-2 lists and describes the functions of the ACS hardware components as well as the 
maximum ACS configuration. 



1. UNIX is a registered trademark of UNIX System Laboratories. Inc. 

2. Sun Workstation is a trademark of Sun Microsystems, Inc. 
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Table 22-2. ACS Hardware 



Hardware 
Component 



Cartridge 



5682-2x cartridge tape 
cabinet 



5680-lx cartridge tape 
controller 



Description 



Plastic housing enclosing magnetic tape on which data is 
stored. This cartridge is IBM 3480-compatible; it has a density 
of 38,000 cpi and a storage capacity of 130 megabytes when 
recorded in I format and 220 megabytes when recorded in LI 
format. Each cartridge has a unique external volume serial 
number (VSN) appearing as a bar-coded identification on the 
edge of the cartridge. Up to 6000 cartridges can be stored in a 
library storage module (LSM). Because NOS uses software to 
enforce the read-only option (PO=R), all cartridges should be 
write enabled (white dot is not visible on the thumbwheel) 
before they are stored in an LSM. 

Cabinet containing cartridge tape units. The 5682-22 cabinet 
contains two tape units; the 5682-24 cabinet contains four tape 
units. The tape units can be operated concurrently. A 
maximum of 16 tape units (four cabinets) can be connected to 
an LSM. 

Controller for the tape units in the 5682-2x (or 5682-lx) 
cabinet. There are four types of controllers: 5680-11, 5680-12, 
5680-13, and 5680-14. The last digit indicates how many FIPS 
channels the controller has. 

A controller can simultaneously position tapes on four tape 
units, but can transfer data to or from only one tape at a time. 

A controller contains a 1 megabyte data buffer to maximize 
transfer rates. This buffer is divided into four 256-kilobyte unit 
buffers so that I/O can be performed simultaneously on four 
units without reusing a buffer. Attempts to simultaneously 
perform I/O on more than four units results in performance 
degradation. 

A controller can be connected to a maximum of two cabinets. A 
maximum of eight controllers can be configured per LSM. 

(Continued on next page) 
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Table 22-2. ACS Hardware 



Hardware 
Component 



Description 



(Continued from previous page) 

5744-10 library storage Twelve-sided cylindrical hardware unit enclosing the cartridge 



module (LSM) 



5744-11 library control 
unit (LCU) 

5744-30 library 
management unit 

(LMU) 



5744-40 cartridge 
library server 
workstation (CLSW) 



storage area and the robot for moving the cartridges. Each 
LSM has storage cells for approximately 6,000 cartridges 
(storing approximately 1,200 gigabytes of data). Up to 16 tape 
units can be connected to an LSM. Up to 16 LSMs can be 
connected in ACS. 

Microprocessor that controls the robot's movements. There is 
one library control unit per library storage module. 

Microprocessor that manages all the library storage modules in 
ACS. The library management unit receives mount requests 
from the workstation and selects a library storage module. 
Sending messages through the library control unit, it instructs 
the robot to select a cartridge, validate its bar-coded 
identification label, retrieve it, mount it in a tape unit, and 
dismount it when the operation is complete. The library 
management unit communicates with the library storage 
modules through a local area network (LAN). There is only one 
library management unit in ACS, and it is attached to all 
library storage modules via the library control units. 

Sun Workstation providing the interface between the CYBEE 
host (via an Ethernet 3 link) and the library storage module. 
The workstation services ACS and is connected to the library 
management unit through an RS423 interface. We recommend 
at least two RS423 connections to provide redundancy. The 
library server software resides on the workstation and 
automates the mounting and dismounting of cartridges. 



3. Ethernet is a trademark of Xerox Corporation. 
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ACS Configurations 

The minimum ACS configuration (as shown in figure 22-4) is: 

• One Sun Workstation with the library server software 

• One cartridge library with one library management unit, one library control unit, and 
one library storage module 

• One NIO channel to the CCC 

• One cartridge tape controller 

• Two cartridge tape units 



CYBER 
Host 



NOS 



Control, 
Path 



I 



CH1 



Ethernet 



Sun 

Workstation 



CYBER 
Channel 
Coupler 



Library 

Management 

Unit 



Library 
Control Unit 



FIPIRP 



F>P|FIP 



Cartridge 

Tape 
Controller 



"N 



Library 



Module 

(LS-O) 





Tape Unit {UN-O, DR-O) 


Panel 




2 


Tape Unit <UN=1,DR=2) 







.Data 
Path 



06553M 



Figure 22-4. ACS Minimum Configuration 
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Communication Paths 

There are two communication paths from the mainframe to a cartridge unit, the control 
path and the data path. These two paths are completely independent; the control path has 
no access to the data path, and the data path has no access to the control path. 

The control path is managed by the ACS library server and is used to mount and dismount 
a cartridge from a unit. The ACS library server has no access to the data on a cartridge. 

The data path is managed by NOS and is used to verify the tape label (if applicable), to 
access data on the volume, and to unload the unit. The same data path can access both tape 
units connected to ACS and tape units connected to CTS. 

A tape unit has two addresses, one for the data path and one for the control path. The 
magnetic tape equipment EST entry defines the data path. The EST entry also defines part 
of the control path; it specifies the exact location of the tape unit in the library storage 
module by specifying the addresses (indexes) of the library storage module, panel, and tape 
unit. The CDCNET configuration file defines the remainder of the control path. 

EQPDECK and IPRDECK Considerations 

In the EQPDECK, you must create EST entries for the ACS tape units; the entries specify 
the exact location of the tape units by using the indexes associated with the library storage 
module, the panel in the module, and the tape unit in the panel. A site can have from 1 to 
16 library storage modules; the library storage module indexes are assigned consecutively 
from to 17 8 . Each library storage module has 12 panels; the panel indexes are assigned 
consecutively from to 13 8 . One tape cabinet can be connected to a panel, and a maximum 
of four panels can have tape cabinets. Within the cabinet, the index of the tape unit (drive) 
is determined by the position of the unit in the cabinet. The uppermost unit has the index 
zero (0), the one beneath has the index one (1), and so on. 

In the IPRDECK you must: 

• Enable the NAM subsystem. Before you enable it, add ATF to the NAM startup file. 

• Decide whether ACS is your site's default device type. If it is, enter: 

TDTY=AT . 

• Decide whether permanent files that reside on ACS as alternate tape storage are 
automatically staged to disk when requested by a user. To automatically stage the files, 
enter: 

ENABLE, ACS TAPE PF STAGING. 

You can also enable file staging with a DSD command. The default is to not stage the 
files. 

The EQPDECK and IPRDECK are described in section 3, Deadstart Decks. 
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Automated Cartridge Subsystem 

Example of Minimum ACS Configuration 

For the minimum configuration shown in figure 22-4, you enter EQPDECK entries and an 
IPRDECK entry. 

The EQPDECK entries, the EST entries for the two tape units, could be: 

EQ60=AT , ST=ON, CH=1 , UK=0 , LS=0 , PA=2 , DR=0 . 
EQ61=AT , ST=ON, CH=1 , UN=1 , LS=0 , PA=2 , DR=2 . 

The IPRDECK entry could specify 9-track tapes as the default tape device type: 

TDTY=NT . 

Example of ACS Configuration with Two Library Storage Modules 

An ACS with two library storage modules is shown in figure 22-5. You can define the EST 
ordinals for the tape units in one library storage module (LS=0) with the EQPDECK entries: 

EQ60=AT , ST=ON, CH=1 , UH=0 , LS=0 , PA=2 , DR=0 . 
EQ61=AT, ST=ON, CH=1 , UM=1 , LS=0 , PA=2 , DR=2 . 

Define the EST ordinals for the tape units in the other library storage module (LS=1) with 
the EQPDECK entries: 

EQ62=AT, ST=ON, CH=1 , UN=2 , LS=1, PA=3 , DR=0 . 
EQ63=AT, ST=ON,CH=l,UN=3,LS=l, PA=3 ,DR=2 . 

The IPRDECK entry could specify 9-track tapes as the default tape device type: 

TDTY=NT. 

For an example of cross-coupled controllers, refer to Cross-Coupled Controllers for CTS and 
ACS. 
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Figure 22-5. ACS Configuration with Two LSMs 
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Cross-Coupled Controllers for CTS and ACS 

Automated Tape Facility Subsystem (ATF) 

The Automated Tape Facility Subsystem (ATF) is a NAM application that enables 
communication between the Sun Workstation software and NOS. The NAM startup file 
activates ATF, and ATF monitors both the network and NOS for requests. To configure 
ATF, refer to the CDCNET Configuration Guide. 

Workstation Commands 

Although ACS normally runs unattended, the Sun Workstation provides a variety of UNIX 
operator commands and utility functions. These commands and utilities enable the 
workstation operator to perform the following tasks: 

Start and stop operations of the workstation. 

Allocate and deallocate library resources. 

Recover library resources if a workstation failure occurs. 

Display the status of all library components. 

Locate a volume within the library. 

Obtain information about cartridges. 

Redistribute scratch volumes. 

Mount and dismount cartridges. 

Enter and eject cartridges from the library. 

Audit the physical contents of storage cells. 

For information about the Sim Workstation commands and utility functions, refer to the 
5744 Automated Cartridge Subsystem (ACS) Administration Guide. 

Cross-Coupled Controllers for CTS and ACS 

In addition to the hardware components previously discussed, you can purchase 5683-33 
cables to cross-couple two tape controllers in either CTS or ACS. Cross-coupling allows: 

• Two cartridges to be read or written simultaneously. 

• One controller to access all the tape units when the other channel or controller is being 
repaired or maintained. 

When you cross-couple controllers, the system automatically selects one controller to access 
all even-numbered tape units and the other controller to access all odd-numbered tape 
units. Consequently, an even-numbered tape unit and an odd-numbered tape unit can be 
accessed concurrently. 

If one of the cross-coupled controllers is faulty, change the status of its channel to off and 
physically turn the controller's switch to offline. Once the faulty controller has processed 
the offline status, the other controller can access all tape units. 
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Cross-Coupled Controllers for CTS and ACS 



CTS Example: 

A pair of cross-coupled controllers for CTS is shown in figure 22-6. The following example 
creates EST entries for the tape units shown in figure 22-6: 

EQ60=CT-4 , ST=ON, CH=l/2 , UN=0 . 

For the preceding EST entry, NOS generates the EST entries: 

EQ60=CT, ST=ON, CH=l/2 ,UN=0 . 
EQ61=CT,ST=ON,CH=l/2,UN=l. 
EQ62=CT, ST=ON, CH=l/2 , UN=2 . 
EQ63=CT, ST=ON, CH=l/2 ,UN=3 . 
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Figure 22-6. CTS Cross-Coupled Controllers 
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Cross-Coupled Controllers for CTS and ACS 



ACS Example: 

A pair of cross-coupled controllers for ACS is shown in figure 22-7. The following example 
creates EST entries for the tape units shown in figure 22-7: 

EQ60=AT, ST=ON, CH=l/2 ,UN=0 ,LS=1 , PA=2 , DR=0 . 
EQ61=AT , ST=ON, CH=l/2 ,UN=1 , LS=1 , PA=2 , DR=1 . 
EQ62=AT , ST=ON, CH=1 / 2 , UW=2 , LS=1 , PA=2 , DR=2 . 
EQ63=AT , ST=ON, CH=l/2 , UN=3 , LS=1 , PA=2 , DR=3 . 
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Requirements for CTS and ACS 

Requirements for CTS and ACS 

CTS and ACS configurations have the following requirements: 

• A CYBER 180 mainframe that has 4X speed peripheral processors (PPs). All models 
835 and higher meet this requirement. 

• The CDCNET communications network. 

• Two PPs per channel connection when F, L, or LI format tapes are used. Otherwise, 
one PP per channel connection when only I format tapes are used. 

• One NIO channel for each CCC connection. 

• A CCC can connect to only one controller. 

• A CCC must be a C model with field change order (FCO) #51479 installed; the 
microcode must be at least at level MB468-D04. 

ACS configurations have the following additional requirements: 

• Install and enable the Tape Management System (TMS). Refer to the NOS Installation 
Handbook and the Tape Management System (TMS) Site Operations Manual. 

• Configure the Automated Tape Facility Subsystem (ATF); refer to the CDCNET 
Configuration Guide. ATF is described earlier in this section. 

• Install the Transmission Control Protocol/Internet Protocol (TCP/IP) and configure TCP 
and UDP. Refer to the CDCNET Configuration Guide. 

• Create an entry for each CYBER system in the I etc I hosts file on the Sun Workstation. 
Refer to the UNIX documentation accompanying the Sun Workstation. 

" Install the library server software on the Sun Workstation. For the appropriate 
software levels, refer to the NOS Software Release Bulletin. For information on 
installing library server software, refer to the 5744 Automated Cartridge Subsystem 
(ACS) Installation and Service manual. 

• Modify the NOS EQPDECK and IPRDECK as described earlier in EQPDECK and 
IPRDECK Considerations. 

Constraints for CTS and ACS 

NOS places the following constraints on both CTS and ACS unless noted otherwise: 

• The maximum number of tape channels is four; this includes reel and cartridge tapes. 

• Cartridge tapes cannot be used as a deadstart device nor as an Express Deadstart 
Dump (EDD) tape. 

• NOS supports only binary mode on cartridge tapes. You can, however, access coded 
mode tapes in binary mode and use the FCOPY command to make the necessary 
character conversion. 

• If NOS is run in secured mode (OPSECM is nonzero), all ACS tape units should be 
defined with the same range of access levels. 
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Performance Considerations for CTS and ACS 

Performance Considerations for CTS and ACS 

The following items affect performance for both CTS and ACS: 

• A cartridge tape controller has four partitions; each partition controls data transfers for 
one tape unit. If a controller controls more than four tape units and receives more than 
four tape requests, the requests are time-shared. For optimum performance, configure 
no more than four tape units per controller. 

• You can connect up to four channels to the same controller to provide either redundant 
access or multiple mainframe access. The maximum I/O throughput is achieved, 
however, with a single channel connection. 

• If a configuration has multiple controllers, cross-couple the controllers for optimum 
performance. 

• If multiple CYBER mainframes share one CTS or ACS configuration, each mainframe 
must have its own dedicated tape unit(s). For optimum performance, configure a 
separate controller for each mainframe. 

• Multiple operating systems can share CTS and ACS. For optimal performance, each 
operating system should have its own separate, dedicated controller and tape unit(s). 

Maintenance for CTS and ACS 

The controller and tape units have extensive self-testing capabilities at power-up and load 
time. For a controller, a customer engineer can also execute inline diagnostics with the 
Detached Diagnostic Device. Before doing preventive or corrective maintenance on a 
controller or tape unit, change the status of its channel to off and physically turn the 
controller's switch to offline. Refer to the 5744 Automated Cartridge Subsystem (ACS) 
Maintenance Manual. 
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Character Sets 



A character set is composed of graphic and control characters. A code set is a set of codes 
used to represent each character within a character set. 

A graphic character may be displayed at a terminal or printed by a line printer. Examples 
are the characters A through Z and the digits through 9. A control character initiates, 
modifies, or stops a control operation. An example is the backspace character that moves 
the te rminal carriage or cursor back one space. Although a control character is not a 
graphic character, a terminal may produce a graphic representation when it receives a 
control character. 

All references within this manual to the ASCII character set or the ASCII code set refer to 
the character set and code set defined in the American National Standard Code for 
Information Interchange (ASCII, ANSI Standard X3.4-1977). References in this manual to 
the ASCII character set do not necessarily refer to the ASCII code set. 

NOS supports the following character sets. 

• CDC graphic 64- (or 63-) character set. 

• ASCII 128-character set. 

• ASCII graphic 64- (or 63-) character set. 

• ASCII graphic 95-character set. 

Each installation selects either the 64-character set or the 63-character set. The differences 
between the two are described next, under Character Set Anomalies. Any reference in this 
appendix to the 64-character set implies either the 63- or 64-character set, unless otherwise 
stated. 

NOS supports the following code sets. 

• 6-bit display code. 

• 6/12-bit display code. 

• 7-bit ASCII code. 

Display code is a set of 6-bit codes from 00 8 to 77 8 . 

The 6/12-bit display code is a combination of 6-bit codes and 12-bit codes. The 6-bit codes 
are 00 8 through 77 8 , excluding 74 8 and 76 8 . (Refer to Character Set Anomalies, next, for the 
interpretation of the 00 8 and 63 8 codes.) The 12-bit codes begin with either 74 8 or 76 8 and 
are followed by a 6-bit code. Thus, 74 8 and 76 8 are considered escape codes and are never 
used as 6-bit codes within the 6/12-bit display code set. The 12-bit codes are 7401 8 , 7402 8 , 
7404 8 , 7407 8 , and 7601 8 through 7677 8 . All other 12-bit codes (74xx 8 and 7600 8 ) are 
undefined. 

The 7-bit ASCII code (as defined by ANSI Standard X3.4-1977) is right-justified in a 12-bit 
byte. Assuming that the bits are numbered from the right starting with 0, bits through 6 
contain the ASCII code, bits 7 through 10 contain zeros, and bit 11 distinguishes the 0000 8 
code from the end-of-line byte. The 7-bit codes are 0001 8 through 0177 8 and 4000 8 . 
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Character Set Anomolies 

NOS interprets two codes differently when the installation selects the 63-character set 
rather than the 64-character set. In tables A-l, A-2, and A3, the codes for the colon and 
percent graphic characters in the 64-character set are unshaded; the codes for the colon and 
percent graphic characters in the 63-character set are shaded. 

If an installation uses the 63-character set, the colon graphic character is always 
represented by a 63 8 code, and the 00 8 code is undefined. However, if the installation uses 
the 64-character set, output of 6/12-bit display codes 7404 8 or 6-bit display code 00 8 
produces a colon. In ASCII mode for interactive jobs, a colon can be input only as a 7404 8 
6/12-bit display code. 

When using either the 63- or 64-character set, the use of undefined 6/12-bit display codes in 
output files produces unpredictable results and should be avoided. 

On input, NOS recognizes alternate 029 punch codes of 11-0 for the right bracket (]) and 12-0 
for the left bracket ([). The alternate codes support the COBOL sign overpunch convention 
and are not recommended for other uses. Refer to the COBOL 5 Reference Manual. 

Also, two 00 8 codes may be confused with an end-of-line byte and should be avoided (refer to 
the NOS 2 Reference Set, Volume 3 for further explanation). 

Translation of 7-bit ASCII to 6-bit display code causes character set folding from the 
128-character ASCII set to the 63- or 64-character ASCII subset. The following special 
character substitutions occur: 

7-Blt ASCII 6-Bit Display Code 

Code Character Code Character 

0140 * 74 8 

0173 { 61 t 



7-Bit ASCII 


Code 


Character 


0100 


e 


0133 


[ 


0134 


\ 


0135 


] 


0136 


a 



0174 | 75 \ 

0175 } 62 ] 

0176 " 76 



Character Set Tables 

This appendix includes character set tables for interactive jobs, batch jobs, and jobs 
involving magnetic tapes. Table A-l is for interactive jobs, and table A-2 is for batch jobs. 
Table A-3 is a conversion table used to cross-reference 7-bit ASCII codes and 6/12-bit 
display codes and to convert ASCII codes from octal to hexadecimal. 

Tables A-4, A-5, and A-6 list the magnetic tape codes and their display code equivalents. 

The character set tables are designed so that you can find the character represented by a 
code (such as in a dump) or find the code that represents a character. To find the character 
represented by a code, look up the code in the column fisting the appropriate code set and 
then find the character on that line in the column fisting the appropriate character set. To 
find the code that represents a character, you first look up the character and then find the 
code on the same line in the appropriate column. 
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Interactive Jobs 

Table A-l shows the character sets and code sets available to you at an ASCII code 
terminal. When in NORMAL mode (specified by the NORMAL command), NOS displays the 
ASCII graphic 64-character set and interprets all input and output as display code. When 
in ASCII mode (specified by the ASCII command), NOS displays the ASCII 128-character 
set and interprets all input and output as 6/12-bit display code. 

To determine the octal or hexadecimal ASCII code for a character, refer to table A-3. 
(Certain terminal definition commands require specification of an ASCII code.) 

On output, the US code is reserved for network use and defined as an end-of-line. Use of 
this character, except in transparent mode, causes incorrect formatting and possible loss of 
output characters. 

Batch Jobs 

Table A-2 fists the CDC graphic 64-character set, the ASCII graphic 64-character set, and 
the ASCII graphic 95-character sets. It also lists the code sets and card punch codes (026 
and 029) that represent the characters. 

The 64-character sets use display code as their code set; the 95-character set uses 7-bit 
ASCII code. The 95-character set is composed of all the characters in the ASCII 
128-character set that can be printed at a line printer (refer to Jobs Using Line Printers, 
next). Only 7-bit ASCII code files can be printed using the ASCII graphic 95-character set. 
To print a 6/12-bit display code file (usually created by an interactive job in ASCII mode), 
you must convert the file to 7-bit ASCII code. To do this, you enter the FCOPY command 
(refer to the NOS 2 Reference Set, Volume 3). The 95-character set is represented by 7-bit 
ASCII codes 0040 8 through 0176 8 . 
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Jobs Using Line Printers 

The batch character set printed depends on the print train used on the line printer to which 
the file is sent (refer to the ROUTE command in the NOS 2 Reference Set, Volume 3). The 
following are the print trains corresponding to each of the batch character sets. 



Character Set 





PSU Printer 


Print Train 


Print Band 


596-1 


- 


596-5 


530-1 


596-6 


530-2 



CDC graphic 64-character set 
ASCII graphic 64-character set 
ASCII graphic 95-character set 



The characters of the default 596-1 print train are listed in the table A-2 column labeled 
CDC Graphic (64 Character); the 596-5 print train characters are listed in the table A-2 
column labeled ASCII Graphic (64 Character); and the 596-6 print train characters are 
listed in the table A-2 column labeled ASCII Graphic (95 Character). 

If a transmission error occurs when printing a line, the system prints the line again. The 
CDC graphic print train prints a concatenation symbol ( . . ) in the first printable column of 
the repeated listing of the line. The ASCII print trains print an underline (_) instead of the 
concatenation symbol. 

If an unprintable character exists in a line (that is, a 7-bit ASCII code outside the range 
0040 8 through 0176 8 ), the number sign (#) appears in the first printable column of a print 
fine, and a space replaces the unprintable character. 

To route and correctly print a 6/12-bit display code file on a line printer with the ASCII 
graphic 95-character set, you must convert the 6/12-bit display code file to a 7-bit ASCII 
code file with the FCOPY command (refer to the NOS 2 Reference Set, Volume 3). The 
resulting 7-bit ASCII file can be routed to a line printer (refer to the ROUTE command in 
the NOS 2 Reference Set, Volume 3) but cannot be output at an interactive terminal. 
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Table A-l. Character Sets for Interactive Jobs 



Ascn 

Graphic 
(64-Character) 



colon 



A 
B 
C 
D 
E 
F 
G 

H 

I 

J 

K 

L 

M 

N 

O 

P 
Q 

R 

S 
T 
U 
V 

w 

X 

Y 

z 



1 

2 
3 

4 



asch 

Character 
(128 Character) 



A 

B 
C 
D 

E 
F 
G 

H 

I 

J 

K 

L 

M 

N 

O 

P 

Q 
R 
S 
T 
U 
V 

w 

X 
Y 
Z 


1 
2 
3 
4 



6-Bit 6/12-Bit 7-Bit 

Display Display ASCH 
Code Code Code 



00 1 - 2 



01 


01 


0101 


02 


02 


0102 


03 


03 


0103 


04 


04 


0104 


05 


05 


0105 


06 


06 


0106 


07 


07 


0107 


10 


10 


0110 


11 


11 


0111 


12 


12 


0112 


13 


13 


0113 


14 


14 


0114 


15 


15 


0115 


16 


16 


0116 


17 


17 


0117 


20 


20 


0120 


21 


21 


0121 


22 


22 


0122 


23 


23 


0123 


24 


24 


0124 


25 


25 


0125 


26 


26 


0126 


27 


27 


0127 


30 


30 


0130 


31 


31 


0131 


32 


32 


0132 


33 


33 


0060 


34 


34 


0061 


35 


35 


0062 


36 


36 


0063 


37 


37 


0064 



1. The interpretation of this character or code may depend on its context. Refer to 
Character Set Anomalies elsewhere in this appendix. 

2. Display code 00 is undefined at sites using the 63-character set. 



(Continued on next page) 



60459300 U 



Character Sets A-5 



Character Set Tables 



Table A-l. Character Sets for Interactive Jobs 



ASCII 


Ascn 


6-Bit 


6/12-Bit 


7-Bit 


Graphic 


Character 


Display 


Display 


ASCH 


(64-Character) 


(128 Character) 


Code 


Code 


Code 


(Continued from previous page) 










5 


5 


40 


40 


0065 


6 


6 


41 


41 


0066 


7 


7 


42 


42 


0067 


8 


8 


43 


43 


0070 


9 


9 


44 


44 


0071 


+ plus 


+ plus 


45 


45 


0053 


- dash 


- dash 


46 


46 


0055 


* asterisk 


* asterisk 


47 


47 


0052 


/ slant 


/slant 


50 


50 


0057 


( opening parenthesis 


( opening parenthesis 


51 


51 


0050 


) closing parenthesis 


) closing parenthesis 


52 


52 


0051 


$ dollar sign 


$ dollar sign 


53 


53 


0044 


= equal 


= equal 


54 


54 


0075 


space 


space 


55 


55 


0040 


, comma 


, comma 


56 


56 


0054 


. period 


. period 


57 


57 


0056 


# number sign 


# number sign 


60 


60 


0043 


[ opening bracket 


[ opening bracket 


61 


61 


0133 


] closing bracket 


] closing bracket 


62 


62 


0135 


% percent sign 


% percent sign 


63 


63 1 


0045 


: colon 


: colon 


63 


63 


0072 


" quote 


" quote 


64 


64 


0042 


_ underline 


_ underline 


65 


65 


0137 


! exclamation point 


! exclamation point 


66 


66 


0041 


& ampersand 


& ampersand 


67 


67 


0046 


' apostrophe 


' apostrophe 


70 


70 


0047 


? question mark 


? question mark 


71 


71 


0077 


< less than 


< less than 


72 


72 


0074 


> greater than 


> greater than 


73 


73 


0076 


@ commercial at 


@ commercial at 


74 1 


7401 


0100 


\ reverse slant 


\ reverse slant 


75 


75 


0134 


A circumflex 


A circumflex 


76 


7402 


0136 


; semicolon 


; semicolon 


77 


77 


0073 


1. The interpretation of this character or code may depend 


on its context. Refer to 




Character Set Anomalies elsewhere 


s in this appendix. 









(Continued on next page) 
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Character Set Tables 



Table A-l. Character Sets for Interactive Jobs 



ASCH 

Graphic 

(64-Character) 



ASCH 
Character 
(128 Character) 



6-Bit 6/12-Bit 7-Bit 
Display Display ASCH 
Code Code Code 



(Continued from, previous page) 



: colon 




7404 


0072 


% percent 




7404 


0045 


' grave accent 


74 1 


7407 


0140 


a 




7601 


0141 


b 




7602 


0142 


c 




7603 


0143 


d 




7604 


0144 


e 




7605 


0145 


f 




7606 


0146 


g 




7607 


0147 


h 




7610 


0150 


i 




7611 


0151 


j 




7612 


0152 


k 




7613 


0153 


1 




7614 


0154 


m 




7615 


0155 


n 




7616 


0156 







7617 


0157 


P 




7620 


0160 


q 




7621 


0161 


r 




7622 


0162 


s 




7623 


0163 


t 




7624 


0164 


u 




7625 


0165 


V 




7626 


0166 


w 




7627 


0167 


X 




7630 


0170 


y 




7631 


0171 


z 




7632 


0172 


{ opening brace 


61 1 


7633 


0173 


I vertical line 


75 1 


7634 


0174 


} closing brace 


62 1 


7635 


0175 


" tilde 


76 1 


7636 


0176 


DEL 




7637 


0177 



1. The interpretation of this character or code may depend on its context. Refer to 
Character Set Anomalies elsewhere in this appendix. 
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Character Set Tables 



Table A-l. Character Sets for Interactive Jobs 



asch 

Graphic 
(64-Character) 

(Continued from previous page) 



asch 

Character 
(128 Character) 



6-Bit 6/12-Bit 7-Bit 
Display Display ASCH 
Code Code Code 



NUL 

SOH 

STX 

ETX 

EOT 

ENQ 

ACK 

BEL 

BS 
HT 
LF 
VT 
FF 
CR 
SO 
SI 

DLE 

DC1 

DC2 

DC3 

DC4 

NAK 

SYN 

ETB 

CAN 

EM 

SUB 

ESC 

FS 

GS 

RS 

US 1 



7640 


4000 


7641 


0001 


7642 


0002 


7643 


0003 


7644 


0004 


7645 


0005 


7646 


0006 


7647 


0007 


7650 


0010 


7651 


0011 


7652 


0012 


7653 


0013 


7654 


0014 


7655 


0015 


7656 


0016 


7657 


0017 


7660 


0020 


7661 


0021 


7662 


0022 


7663 


0023 


7664 


0024 


7665 


0025 


7666 


0026 


7667 


0027 


7670 


0030 


7671 


0031 


7672 


0032 


7673 


0033 


7674 


0034 


7675 


0035 


7676 


0036 


7677 


0037 



1. Reserved for network use. Refer to Character Set Tables in this appendix. 



A-8 NOS Version 2 Analysis Handbook 



60459300 U 



Character Set Tables 



Table A-2. Character Sets for Batch Jobs 











6/12- 








CDC 


asch 


asch 


6-Bit 


Bit 








Graphic 


Graphic 


Graphic 


Dis- 


Dis- 


7-Bit 


Punch 


Punch 


(64 


(64 


(95 


play 


play 


ASCH 


Code 


Code 


Character) 


Character) 

: colon 1 


Character) 


Code 


Code 


Code 


026 


029 


: colon 1 ' 2 




OO 1 






8-2 


8-2 


A 


A 


A 


01 


01 


0101 


12-1 


12-1 


B 


B 


B 


02 


02 


0102 


12-2 


12-2 


C 


C 


C 


03 


03 


0103 


12-3 


12-3 


D 


D 


D 


04 


04 


0104 


12-4 


12-4 


E 


E 


E 


05 


05 


0105 


12-5 


12-5 


F 


F 


F 


06 


06 


0106 


12-6 


12-6 


G 


G 


G 


07 


07 


0107 


12-7 


12-7 


H 


H 


H 


10 


10 


0110 


12-8 


12-8 


I 


I 


I 


11 


11 


0111 


12-9 


12-9 


J 


J 


J 


12 


12 


0112 


11-1 


11-1 


K 


K 


K 


13 


13 


0113 


11-2 


11-2 


L 


L 


L 


14 


14 


0114 


11-3 


11-3 


M 


M 


M 


15 


15 


0115 


11-4 


11-4 


N 


N 


N 


16 


16 


0116 


11-5 


11-5 











17 


17 


0117 


11-6 


11-6 


P 


P 


P 


20 


20 


0120 


11-7 


11-7 


Q 


Q 


Q 


21 


21 


0121 


11-8 


11-8 


R 


R 


R 


22 


22 


0122 


11-9 


11-9 


S 


S 


S 


23 


23 


0123 


0-2 


0-2 


T 


T 


T 


24 


24 


0124 


0-3 


0-3 


U 


U 


U 


25 


25 


0125 


0-4 


0-4 


V 


V 


V 


26 


26 


0126 


0-5 


0-5 


w 


W 


w 


27 


27 


0127 


0-6 


0-6 


X 


X 


X 


30 


30 


0130 


0-7 


0-7 


Y 


Y 


Y 


31 


31 


0131 


0-8 


0-8 


Z 


Z 


z 


32 


32 


0132 


0-9 


0-9 











33 


33 


0060 








1 


1 


1 


34 


34 


0061 


1 


1 


2 


2 


2 


35 


35 


0062 


2 


2 


3 


3 


3 


36 


36 


0063 


3 


3 


4 


4 


4 


37 


37 


0064 


4 


4 



1. The interpretation of this character or code may depend on its context. Refer to 
Character Set Anomalies elsewhere in this appendix. 



2. Display code 00 is undefined at sites using the 63-character set. 
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Table A-2. Character Sets for Batch Jobs 











6/12- 








CDC 


Ascn 


Ascn 


6-Bit 


Bit 








Graphic 


Graphic 


Graphic 


Dis- 


Dis- 


7-Bit 


Punch 


Punch 


(64 


(64 


(95 


play 


play 


ASCII 


Code 


Code 


Character) 


Character) 


Character) 


Code 


Code 


Code 


026 


029 


(Continued fr 


om previous page) 












5 


5 


5 


40 


40 


0065 


5 


5 


6 


6 


6 


41 


41 


0066 


6 


6 


7 


7 


7 


42 


42 


0067 


7 


7 


8 


8 


8 


43 


43 


0070 


8 


8 


9 


9 


9 


44 


44 


0071 


9 


9 


+ plus 


+ plus 


+ plus 


45 


45 


0053 


12 


12-8-6 


- dash 


- dash 


-dash 


46 


46 


0055 


11 


11 


* asterisk 


* asterisk 


* asterisk 


47 


47 


0052 


11-8-4 


11-8-4 


/slant 


/ slant 


/slant 


50 


50 


0057 


0-1 


0-1 


( opening 


( opening 


( opening 


51 


51 


0050 


0-8-4 


12-8-5 


parenthesis 


parenthesis 


parenthesis 












) closing 


) closing 


) closing 


52 


52 


0051 


12-8-4 


11-8-5 


parenthesis 


parenthesis 


parenthesis 












$ dollar sign 


$ dollar sign 


$ dollar sign 


53 


53 


0044 


11-8-3 


11-8-3 


= equal 


= equal 


= equal 


54 


54 


0075 


8-3 


8-6 


space 


space 


space 


55 


55 


0040 


no 
punch 


no 
punch 


, comma 


, comma 


, comma 


56 


56 


0054 


0-8-3 


0-8-3 


. period 


. period 


. period 


57 


57 


0056 


12-8-3 


12-8-3 


s 


# number 


# number 


60 


60 


0043 


0-8-6 


8-3 


equivalence 


sign 


sign 












[ opening 


[ opening 


[ opening 


61 


61 


0133 


8-7 


12-8-2 1 


bracket 


bracket 


bracket 












] closing 


] closing 


] closing 


62 


62 


0135 


0-8-2 


11-8-2 1 


bracket 


bracket 


bracket 












% percent 


% percent 


% percent 


63 1 


63 1 


0045 


8-6 


0-8-4 


sign 1 


sign 1 


sign 1 












: colon 


: colon 


: colon 


63 


63 


0072 


8-2 


8-2 


* not equal 


" quote 


"quote 


64 


64 


0042 


8-4 


8-7 


. . 






65 


65 


0137 


0-8-5 


0-8-5 


concaten- 


underline 


underline 












ation 
















v logical 


! exclam- 


! exclam- 


66 


66 


0041 


11-0 


12-8-7 


OR 


ation point 


ation point 












a logical 


& 


& 


67 


67 


0046 


0-8-7 


12 


AND 


ampersand 


ampersand 












1. The interpretation of this character or code may 


depend 


on its context. Refer to 


Character Set Anomalies elsewhere in this appendix. 
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Table A-2. Character Sets for Batch Jobs 











6/12- 








CDC 


Ascn 


ASCII 


6-Bit 


Bit 








Graphic 


Graphic 


Graphic 


Dis- 


Dis- 


7-Bit 


Punch 


Punch 


(64 


(64 


(95 


play 


play 


ASCH 


Code 


Code 


Character) 


Character) 


Character) 


Code 


Code 


Code 


026 


029 


(Continued fn 


om previous page) 












T 


' apostrophe 


' apostrophe 


70 


70 


0047 


11-8-5 


8-5 


superscript 
















1 


? question 


? question 


71 


71 


0077 


11-8-6 


0-8-7 


subscript 


mark 


mark 












< less 


< less 


< less 


72 


72 


0074 


12-0 


12-8-4 


than 


than 


than 












> greater 


> greater 


> greater 


73 


73 


0076 


11-8-7 


0-8-6 


than 


than 


than 












<less 


@ 




74 






8-5 


8-4 


or equal 


commercial 
at 














> greater 


\ reverse 


\ reverse 


75 


75 


0134 


12-8-5 


0-8-2 


or equal 


slant 


slant 












- logical 


A circumflex 




76 






12-8-6 


11-8-7 


NOT 
















; semicolon 


; semicolon 


; semicolon 


77 


77 


0073 


12-8-7 


11-8-6 






@ 


741 


7401 


0100 










commercial 
















at 
















A circumflex 


76 1 


7402 


0136 










: colon 1 




7404 1 


0072 










% percent 




7404 


0045 










sign 
















' grave 


74l 


7407 


0140 










accent 
















a 




7601 


0141 










b 




7602 


0142 










c 




7603 


0143 










d 




7604 


0144 










e 




7605 


0145 










f 




7606 


0146 










g 




7607 


0147 






1. The interpretation of this character or code may 


depend 


on its context. Refer to 


Character Set Anomalies elsewhere in this appendix. 
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6/12- 






cdc asch Ascn 


6-Bit 


Bit 






Graphic Graphic Graphic 


Dis- 


Dis- 


7-Bit 


Punch Punch 


(64 (64 (95 


play 


play 


Ascn 


Code Code 


Character) Character) Character) 


Code 


Code 


Code 


026 029 


(Continued from previous page) 










h 




7610 


0150 




i 




7611 


0151 




J 




7612 


0152 




k 




7613 


0153 




1 




7614 


0154 




m 




7615 


0155 




n 




7616 


0156 









7617 


0157 




P 




7620 


0160 




q 




7621 


0161 




r 




7622 


0162 




s 




7623 


0163 




t 




7624 


0164 




u 




7625 


0165 




V 




7626 


0166 




w 




7627 


0167 




X 




7630 


0170 




y 




7631 


0171 




z 




7632 


0172 




{ opening 


61 1 


7633 


0173 




brace 










1 vertical 


75 1 


7634 


0174 




line 










} closing 


62 1 


7635 


0175 




brace 










" tilde 


76 1 


7636 


0176 




1. The interpretation of this character or ( 


:ode may 


depend 


on its context. Refer to 


Character Set Anomalies elsewhere in this appendix. 
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Table A-3. ASCII to 6/12-Bit Display Code Conversion 



ASCII 


7-Bit 


7-Bit 


6/12-Bit 


Character 


ASCII Code 


ASCII Code 


Display 


(128 Character) 


Octal 


Hexadecimal 


Code 


NUL 


4000 


00 


7640 


SOH 


0001 


01 


7641 


STX 


0002 


02 


7642 


ETX 


0003 


03 


7643 


EOT 


0004 


04 


7644 


ENQ 


0005 


05 


7645 


ACK 


0006 


06 


7646 


BEL 


0007 


07 


7647 


BS 


0010 


08 


7650 


HT 


0011 


09 


7651 


LF 


0012 


0A 


7652 


VT 


0013 


0B 


7653 


FF 


0014 


OC 


7654 


CR 


0015 


0D 


7655 


SO 


0016 


0E 


7656 


SI 


0017 


OF 


7657 


DLE 


0020 


10 


7660 


DC1 


0021 


11 


7661 


DC2 


0022 


12 


7662 


DC3 


0023 


13 


7663 


DC4 


0024 


14 


7664 


NAK 


0025 


15 


7665 


SYN 


0026 


16 


7666 


ETB 


0027 


17 


7667 


CAN 


0030 


18 


7670 


EM 


0031 


19 


7671 


SUB 


0032 


1A 


7672 


ESC 


0033 


IB 


7673 


FS 


0034 


1C 


7674 


GS 


0035 


ID 


7675 


RS 


0036 


IE 


7676 


US 1 


0037 


IF 


7677 1 


space 


0040 


20 


55 


! exclamation point 


0041 


21 


66 


" quote 


0042 


22 


64 


# number sign 


0043 


23 


60 


$ dollar sign 


0044 


24 


53 


% percent sign 2 


0045 


25 


63 2 



1. Reserved for network use. Refer to Character Set Tables in this appendix. 

2. The interpretation of this character or code may depend on its context. Refer to 
Character Set Anomalies in this appendix. 
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Table A-3. ASCII to 6/12-Bit Display Code Conversion 



asch 


7-Bit 


7-Bit 


6/12-Bit 


Character 


ASCII Code 


ASCII Code 


Display 


(128 Character) 


Octal 


Hexadecimal 


Code 


(Continued from previous page) 






% percent sign 


0045 


25 


7404 


& ampersand 


0046 


26 


67 


' apostrophe 


0047 


27 


70 


( opening parenthesis 


0050 


28 


51 


) closing parenthesis 


0051 


29 


52 


* asterisk 


0052 


2A 


47 


+ plus 


0053 


2B 


45 


, comma 


0054 


2C 


56 


- dash 


0055 


2D 


46 


. period 


0056 


2E 


57 


/slant 


0057 


2F 


50 





0060 


30 


33 


1 


0061 


31 


34 


2 


0062 


32 


35 


3 


0063 


33 


36 


4 


0064 


34 


37 


5 


0065 


35 


40 


6 


0066 


36 


41 


7 


0067 


37 


42 


8 


0070 


38 


43 


9 


0071 


39 


44 


: colon 1 


0072 


3A 


7404 1 


: colon 


0072 


3A 


63 


; semicolon 


0073 


3B 


77 


< less than 


0074 


3C 


72 


= equal 


0075 


3D 


54 


> greater than 


0076 


3E 


73 


? question mark 


0077 


3F 


71 


@ commercial at 


0100 


40 


7401 


A 


0101 


41 


01 


B 


0102 


42 


02 


C 


0103 


43 


03 


D 


0104 


44 


04 


E 


0105 


45 


05 


F 


0106 


46 


06 


G 


0107 


47 


07 


H 


0110 


48 


10 


1. The interpretation of this character or code 


may depend on its context. Refer to 


Character Set Anomalies 


in this appendix. 
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Table A-3. ASCII to 6/12-Bit Display Code Conversion 



asch 


7-Bit 


7-Bit 


6/12-Bit 


Character 


ASCn Code 


ASCII Code 


Display 


(128 Character) 


Octal 


Hexadecimal 


Code 


(Continued from previous 


page) 






I 


0111 


49 


11 


J 


0112 


4A 


12 


K 


0113 


4B 


13 


L 


0114 


4C 


14 


M 


0115 


4D 


15 


N 


0116 


4E 


16 


O 


0117 


4F 


17 


P 


0120 


50 


20 


Q 


0121 


51 


21 


R 


0122 


52 


22 


S 


0123 


53 


23 


T 


0124 


54 


24 


U 


0125 


55 


25 


V 


0126 


56 


26 


W 


0127 


57 


27 


X 


0130 


58 


30 


Y 


0131 


59 


31 


z 


0132 


5A 


32 


[ opening bracket 


0133 


5B 


61 


\ reverse slant 


0134 


5C 


75 


] closing bracket 


0135 


5D 


62 


A circumflex 


0136 


5E 


7402 


_ underline 


0137 


5F 


65 


' grave accent 


0140 


60 


7407 


a 


0141 


61 


7601 


b 


0142 


62 


7602 


c 


0143 


63 


7603 


d 


0144 


64 


7604 


e 


0145 


65 


7605 


f 


0146 


66 


7606 


S 


0147 


67 


7607 


h 


0150 


68 


7610 


i 


0151 


69 


7611 


j 


0152 


6A 


7612 


k 


0153 


6B 


7613 


1 


0154 


6C 


7614 


m 


0155 


6D 


7615 


n 


0156 


6E 


7616 





0157 


6F 


7617 
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Table A-3. ASCII to 6/12-Bit Display Code Conversion 



Ascn 


7-Bit 


7-Bit 


6/12-Bit 


Character 


ASCH Code 


ASCII Code 


Display 


(128 Character) 


Octal 


Hexadecimal 


Code 


(Continued from previous 


page) 






P 


0160 


70 


7620 


q 


0161 


71 


7621 


r 


0162 


72 


7622 


s 


0163 


73 


7623 


t 


0164 


74 


7624 


u 


0165 


75 


7625 


V 


0166 


76 


7626 


w 


0167 


77 


7627 


X 


0170 


78 


7630 


y 


0171 


79 


7631 


z 


0172 


7A 


7632 


{ opening brace 


0173 


7B 


7633 


1 vertical line 


0174 


7C 


7634 


} closing brace 


0175 


7D 


7635 


' tilde 


0176 


7E 


7636 


DEL 


0177 


7F 


7637 
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Jobs Using Magnetic Tape 

Coded data to be copied from disk to magnetic tape is assumed to be represented in display 
code. NOS converts the data to external BCD code when writing a coded 7-track tape and to 
ASCII or EBCDIC code (as specified on the tape assignment command) when writing a 
coded 9-track tape. 

Because only 63 characters can be represented in 7-track even parity, one of the 64 display 
codes is lost in conversion to and from external BCD code. Figure A-l shows the differences 
in conversion depending on the character set (63 or 64) that the system uses. The ASCII 
character for the specified character code is shown in parentheses. The output arrow shows 
how the 6-bit display code changes when it is written on tape in external BCD. The input 
arrow shows how the external BCD code changes when the tape is read and converted to 
6-bit display code. 





63-Cbaractec Sec 






6-Bit Display Code 


External BCD 
16 (Z) 




6-Bit Display Code 


00 


00 


33 <0) Output 


12 (0) 
12 (0) 


Input 


33 <0) 
33 (0) 


63 {:) 






64-Character Set 






6-Bit Display Code 


External BCD 




6-Bit Display Code 


00 (O 


12 (0) 




33 <0) 


33 <0) Output 


12 (0) 
16 (I) 


Input 


33 (0) 
63 <X> 


63 (I) * 





Figure A-l. Conversion Differences 

If a lowercase ASCII or EBCDIC code is read from a 9-track coded tape, it is converted to its 
uppercase 6-bit display code equivalent. To read or write lowercase ASCII or EBCDIC 
characters, you must assign the tape in binary mode and use FCOPY to read or write the 
tape. 

Tables A-4 and A-5 show the character set conversion for 9-track tapes. Table A-4 lists the 
conversions to and from the 7-bit ASCII character code and 6-bit display code. Table A-5 
lists the conversions between the EBCDIC character code and the 6-bit display code. Table 
A-6 shows the character set conversions between external BCD and 6-bit display code for 
7-track tapes. 
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Table A-4. Nine-Track ASCII Coded Tape Conversion 













6-Bit 


7-Bit 




7-Bit 




6-Bit 


Display 


ASCII 


7-Bit 


ASCH 


7-Bit 


Display 


Code 


Code 


Ascn 


Code 


ASCH 


Code 


Code 


(Hex) 


Char 1 


(Hex) 


Char 2 


Char 


(Octal) 


20 


space 


00 


NUL 


space 


55 


21 


r 


7D 


} 


! 


66 


22 


it 


02 


STX 


ii 


64 


23 


# 


03 


ETX 


# 


60 


24 


$ 


04 


EOT 


$ 


53 


25 


% 


05 


ENQ 


% 


63 


25 


% 


05 


ENQ 


space 3 


55 


26 


& 


06 


ACK 


& 


67 


27 


? 


07 


BEL 


? 


70 


28 


( 


08 


BS 


( 


51 


29 


) 


09 


HT 


) 


52 


2A 


* 


0A 


LF 


* 


47 


2B 


+ 


0B 


VT 


+ 


45 


2C 


? 


OC 


FF 


? 


56 


2D 




0D 


CR 


— 


46 


2E 




0E 


SO 


. 


57 


2F 


/ 


OF 


SI 


/ 


50 


30 





10 


DLE 





33 


31 


1 


11 


DC1 


1 


34 


32 


2 


12 


DC2 


2 


35 


33 


3 


13 


DC3 


3 


36 


34 


4 


14 


DC4 


4 


37 


35 


5 


15 


NAK 


5 


40 


36 


6 


16 


SYN 


6 


41 


37 


7 


17 


ETB 


7 


42 


38 


8 


18 


CAN 


8 


43 


39 


9 


19 


EM 


9 


44 


3A 


: 


1A 


SUB 4 


: 


00 


3A 


: 


1A 


SUB 


• 


63 


3B 


) 


IB 


ESC 


? 


77 


3C 


< 


7B 


{ 


< 


72 


3D 


= 


ID 


GS 


= 


54 



1. When these characters are copied from/or to a tape, the characters remain the same 
but the codes change from one code set to the other. 

2. These characters do not exist in 6-bit display code. Therefore, when the characters are 
copied from a tape, each 7-bit ASCII character is changed to an alternate 6-bit display 
code character. The corresponding codes are also changed. Example: When the system 
copies a lowercase a, 61 16 , from tape, it writes an uppercase A, 01 8 . 

3. A 6-bit display code space always translates to a 7-bit ASCII space. 

4. 6-Bit display code 00 is undefined at sites using the 63-character set. 

(Continued on next page) 
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Table A-4. Nine-Track ASCII Coded Tape Conversion 













6-Bit 


7-Bit 




7-Bit 




6-Bit 


Display 


Ascn 


7-Bit 


ASCH 


7-Bit 


Display 


Code 


Code 


ASCH 


Code 


ASCH 


Code 


Code 


(Hex) 


Char 1 

d from previous 


(Hex) 


Char 2 


Char 


(Octal) 


(Continue* 


page) 








3E 


> 


IE 


RS 


> 


73 


3F 


? 


IF 


US 


? 


71 


40 


@ 


60 


t 


@ 


74 


41 


A 


61 


a 


A 


01 


42 


B 


62 


b 


B 


02 


43 


C 


63 


c 


C 


03 


44 


D 


64 


d 


D 


04 


45 


E 


65 


e 


E 


05 


46 


F 


66 


f 


F 


06 


47 


G 


67 


g 


G 


07 


48 


H 


68 


h 


H 


10 


49 


I 


69 


i 


I 


11 


4A 


J 


6A 


J 


J 


12 


4B 


K 


6B 


k 


K 


13 


4C 


L 


6C 


1 


L 


14 


4D 


M 


6D 


m 


M 


15 


4E 


N 


6E 


n 


N 


16 


4F 





6F 








17 


50 


P 


70 


P 


P 


20 


51 


Q 


71 


q 


Q 


21 


52 


R 


72 


r 


R 


22 


53 


S 


73 


s 


S 


23 


54 


T 


74 


t 


T 


24 


55 


U 


75 


u 


U 


25 


56 


V 


76 


V 


V 


26 


57 


w 


77 


w 


w 


27 


58 


X 


78 


X 


X 


30 


59 


Y 


79 


y 


Y 


31 


5A 


z 


7A 


z 


Z 


32 


5B 


[ 


1C 


FS 


[ 


61 


5C 


\ 


7C 


1 


\ 


75 


5D 


] 


01 


SOH 


] 


62 


5E 


A 


7E 


"" 


A 


76 


5F 




7F 


DEL 


_ 


65 



1. When these characters are copied from/or to a tape, the characters remain the same 
but the codes change from one code set to the other. 

2 These characters do not exist in 6-bit display code. Therefore, when the characters are 
copied from a tape, each 7-bit ASCII character is changed to an alternate 6-bit display 
code character. The corresponding codes are also changed. Example: When the system 
copies a lowercase a, 61 16 , from tape, it writes an uppercase A, 01 8 . 
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Character Set Tables 



Table A-5. Nine-Track EBCDIC Coded Tape Conversion 













6-Bit 










6-Bit 


Display 


EBCDIC 




EBCDIC 




Display 


Code 


Code 


EBCDIC 


Code 


EBCDIC 


Code 


Code 


(Hex) 


Char 1 


(Hex) 


Char 2 


Char 


(Octal) 


40 


space 


00 


NUL 


space 


55 


4A 





1C 


IFS 


[ 


61 


4B 




0E 


SO 




57 


4C 


< 


CO 


{ 


< 


72 


4D 


( 


16 


BS 


( 


51 


4E 


+ 


0B 


VT 


+ 


45 


4F 


1 


DO 


} 


! 


66 


50 


& 


2E 


ACK 


& 


67 


5A 


! 


01 


SOH 


] 


62 


5B 


$ 


37 


EOT 


$ 


53 


5C 


* 


25 


LF 


* 


47 


5D 


) 


05 


HT 


) 


52 


5E 


5 


27 


ESC 


? 


77 


5F 


— 


Al 


- 


A 


76 


60 


— 


0D 


CR 


_ 


46 


61 


/ 


OF 


SI 


/ 


50 


6B 


> 


0C 


FF 


y 


56 


6C 


% 


2D 


ENQ 


% 


63 


6C 


% 


2D 


ENQ 


space 3 


55 


6D 




07 


DEL 




65 


6E 


> 


IE 


IRS 


> 


73 


6F 


? 


IF 


IUS 


? 


71 


7A 


•' 


3F 


SUB 4 




00 


7A 


' 


3F 


SUB 


• 


63 



1. When these characters are copied from/or to a tape, the characters remain the same 
(except EBCDIC codes 4A 4F, 5A, and 5F) but the codes change from one code set to the 
other. 

2. These characters do not exist in 6-bit display code. Therefore, when the characters are 
copied from a tape, each EBCDIC character is changed to an alternate 6-bit display code 
character. The corresponding codes are also changed. Example: When the system copies a 
lowercase a, 81 16 , from tape, it writes an uppercase A, 01 8 . 

3. All EBCDIC codes not listed translate to 6-bit display code 55 8 (space). A 6-bit display 
code space always translates to an EBCDIC space. 

4. 6-Bit display code 00 is undefined at sites using the 63-character set. 



(Continued on next page) 
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Character Set Tables 



Table A-5. Nine-Track EBCDIC Coded Tape Conversion 













6-Bit 










6-Bit 


Display 


EBCDIC 




EBCDIC 




Display 


Code 


Code 


EBCDIC 


Code 


EBCDIC 


Code 


Code 


(Hex) 


Char 1 


(Hex) 


Char 2 


Char 


(Octal) 


(Continued from previous page) 








7B 


# 


03 


ETX 


# 


60 


7C 


@ 


79 


\ 


@ 


74 


7D 


7 


2F 


BEL 


? 


70 


7E 


= 


ID 


IGS 


= 


54 


7F 


it 


02 


STX 


ii 


64 


CI 


A 


81 


a 


A 


01 


C2 


B 


82 


b 


B 


02 


C3 


C 


83 


c 


C 


03 


C4 


D 


84 


d 


D 


04 


C5 


E 


85 


e 


E 


05 


C6 


F 


86 


f 


F 


06 


C7 


G 


87 


g 


G 


07 


C8 


H 


88 


h 


H 


10 


C9 


I 


89 


i 


I 


11 


Dl 


J 


91 


J 


J 


12 


D2 


K 


92 


k 


K 


13 


D3 


L 


93 


1 


L 


14 


D4 


M 


94 


m 


M 


15 


D5 


N 


95 


n 


N 


16 


D6 





96 


o 





17 


D7 


P 


97 


P 


P 


20 


D8 


Q 


98 


q 


Q 


21 


D9 


R 


99 


r 


R 


22 


EO 


\ 


6A 


1 


\ 


75 


E2 


s 


A2 


s 


S 


23 


E3 


T 


A3 


t 


T 


24 


E4 


U 


A4 


u 


U 


25 


E5 


V 


A5 


V 


V 


26 


E6 


w 


A6 


w 


w 


27 


E7 


X 


A7 


X 


X 


30 



1. When these characters are copied from/or to a tape, the characters remain the same 
(except EBCDIC codes 4A, 4F, 5A, and 5F) but the codes change from one code set to the 
other. 

2. These characters do not exist in 6-bit display code. Therefore, when the characters are 
copied from a tape, each EBCDIC character is changed to an alternate 6-bit display code 
character. The corresponding codes are also changed. Example: When the system copies a 
lowercase a, 81 16 , from tape, it writes an uppercase A, 01 8 . _^_ 



(Continued on next page) 
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Character Set Tables 



Table A-5. Nine-Track EBCDIC Coded Tape Conversion 











6-Bit 








6-Bit 


Display 


EBCDIC 


EBCDIC 




Display 


Code 


Code EBCDIC 


Code 


EBCDIC 


Code 


Code 


(Hex) Cbar 1 


(Hex) 

•page) 


Char 2 


Char 


(Octal) 


(Continued from previous 






E8 Y 


A8 


y 


Y 


31 


E9 Z 


A9 


z 


Z 


32 


FO 


10 


DLE 





33 


Fl 1 


11 


DC1 


1 


34 


F2 2 


12 


DC2 


2 


35 


F3 3 


13 


TM 


3 


36 


F4 4 


3C 


DC4 


4 


37 


F5 5 


3D 


NAK 


5 


40 


F6 6 


32 


SYN 


6 


41 


F7 7 


26 


ETB 


7 


42 


F8 8 


18 


CAN 


8 


43 


F9 9 


19 


EM 


9 


44 



1. When these characters are copied from/or to a tape, the characters remain the same 
(except EBCDIC codes 4A, 4F, 5A, and 5F) but the codes change from one code set to the 
other. 

2. These characters do not exist in 6-bit display code. Therefore, when the characters are 
copied from a tape, each EBCDIC character is changed to an alternate 6-bit display code 
character. The corresponding codes are also changed. Example: When the system copies a 
lowercase a, 81 16 , from tape, it writes an uppercase A, 01 8 . 



A-22 NOS Version 2 Analysis Handbook 



60459300 U 



Character Set Tables 



Table A-6. Seven-Track Coded Tape Conversions 



External ASCII 6-Bit 

BCD Character Display Code (Octal) 



01 1 34 

02 2 35 

03 3 36 

04 4 37 

05 5 40 

06 6 41 

07 7 42 

10 8 43 

11 9 44 
12 1 33 

13 = 54 

14 " 64 

15 @ 74 
16 1 % 63 
17 [ 61 

20 space 55 

21 / 50 

22 S 23 

23 T 24 

24 U 25 

25 V 26 

26 W 27 

27 X 30 

30 Y 31 

31 Z 32 

32 ] 62 

33 , 56 

34 ( 51 

35 _ 65 

36 # 60 

37 & 67 



1. As explained previously in this appendix, conversion of these codes depends on whether 
the tape is being read or written. ____ 



(Continued on next page) 
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Character Set Tables 



Table A-6. Seven-Track Coded Tape Conversions 



External 
BCD 



Ascn 

Character 



6-Bit 

Display Code (Octal) 



(Continued from previous page) 
40 



41 
42 
43 
44 
45 
46 
47 
50 
51 
52 
53 
54 
55 
56 
57 
60 
61 
62 
63 
64 
65 
66 
67 
70 
71 
72 
73 
74 
75 
76 
77 



J 
K 

L 
M 
N 
O 
P 

Q 

R 

! 

$ 
* 



> 

+ 

A 

B 

C 

D 

E 

F 

G 

H 

I 

< 

) 
\ 

A 



46 
12 
13 
14 
15 
16 
17 
20 
21 
22 
66 
53 
47 
70 
71 
73 
45 
01 
02 
03 
04 
05 
06 
07 
10 
11 
72 
57 
52 
75 
76 
77 
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Glossary B 



Access Category 

See File Access Category and System Access Categories. 
Access Code 

A hardware/software security code assigned to each NAD on the network. A NAD may 
communicate only with other NADs having matching codes. 

Access Level 

A property of each file, job, and equipment on a secured system that is used to indicate the 
sensitivity of information in the file or job, or the sensitivity of information that can be 
processed by the equipment. On a secured system, there are up to eight access levels 
corresponding to increasing levels of sensitivity; you are authorized to access some or all of 
those levels. Refer also to Equipment Access Levels, File Access Level, Job Access Level, 
and System Access Levels. 

Access Level Limits 

See Job Access Level Limits. 
Account Dayfile 

A dayfile that provides a history of system usage over the life of the account. It provides 
information necessary for accurate billing and system usage analysis. 

ACN 

See Application Connection Number. 

ACS 

See Automated Cartridge Subsystem. 

AFD Utility 

A dayfile dumping utility that dumps all or selected parts of the account dayfile to produce a 
listing. 

AIP Trace Utility 

See Application Interface Program Trace Utility. 
Allocation Summary Table (AST) 

A table that contains information used by the allocation algorithm to select the cartridges 
on which a file will reside in an MSE environment. 

Allocation Unit (AU) 

In an MSE environment, an allocation unit is the smallest allocatable portion of a cartridge. 
Each AU consists of 14 data strips; each cartridge has 1931 AUs. 
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Alternate Storage 



Alternate Storage 

The storage of permanent file data on external media other than mass storage such as MSE, 
tape, or optical disk alternate storage. When a file resides on alternate storage, the file's 
permanent file catalog (PFC) entry and permit data still reside on disk, but the disk space 
occupied by the file data can be released. 

Alternate Storage Address (ASA) 

The pointers in a file's PFC entry that point to the location of the file data on MSE, tape, or 
optical disk alternate storage. 

Application 

See Application Program. 

Application Connection Number (ACN) 

A number assigned by the NAM program to identify a particular logical connection within 
an application. 

Application Interface Program (ACP) Trace Utility 

A utility that produces a trace file of the messages transferred between IAF and NAM. The 
information contained in this trace can be useful in tracking network problems and in 
debugging application programs. 

Application Program 

A program resident in a host computer that provides an information storage, retrieval, 
and/or processing service to a remote user via the data communication network and the 
Network Access Method. Application programs use the system control point feature of NOS 
to communicate with the Network Access Method. 

In the context of network software, an application program is not an interactive job, but 
rather a terminal servicing facility that provides terminal users with a specific processing 
capability such as remote job entry from batch terminals, transaction processing, entry and 
execution of interactive jobs, and so forth. For example, the standard Control Data 
Interactive Facility IAF makes terminal input and output appear the same to an executing 
program as file input and output; IAF is a network application program, but the executing 
program using IAF is an interactive job. 

Archive Files 

A dump of permanent files accumulated on disk that are dumped as a whole or in part to a 
backup tape (or other type of backup medium) to protect the files from loss in case of a 
device malfunction or to free a device for temporary use during preventive maintenance. 

ASCII 

American National Standard Code for Information Interchange. The standard character set 
and code used for information interchange between systems. It is a 7-bit code representing 
a prescribed set of 128 characters. 

AST 

See Allocation Summary Table. 
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ATF 

See Automated Tape Facility. 
Attach 



The process of making a direct access permanent file accessible to a job by specifying the 
proper permanent file identification and passwords. 

AU 

See Allocation Unit. 
Auto Recall 

The act of a program releasing control of the CPU until a requested function is complete. 
Refer to Recall. 

Automated Cartridge Subsystem (ACS) 

The Control Data 5744 Automated Cartridge Subsystem (ACS) consists of hardware and 
software that allow reading and writing of ACS tapes (IBM 3480-compatible cartridge 
tapes). The ACS hardware includes a robot that automatically loads and unloads the 
cartridge tapes. Contrast with Cartridge Tape Subsystem. 

Automated Tape Facility (ATF) 

The Automated Tape Facility (ATF) is a NAM application that enables communication 
between the ACS library server (Sun Workstation) software and NOS. ATF must be active 
before users can access the Automated Cartridge Subsystem. 

Auxiliary Device 

A disk device that is not part of a permanent file family. Auxiliary devices can contain 
direct or indirect access permanent files. 

B 

Backup Tape 

See Archive Files. 
Batch Job 

The instructions and data that are submitted as a complete unit without further user 
intervention. The job can be punched on cards or created and submitted from a terminal. 

Beginning-of-Information (BOI) 

The start of the first programmer record in a file is known as the beginnmg-of-information. 
System information, such as tape labels on sequential files or indexes, does not affect the 
beginning-of-information. 

Binary File 

A noneditable file that contains a precompiled program. 
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BOI 

BOI 

See Beginning-of-Information. 
Breakpoint 

A designated location in a program where, if reached during program execution, a break or 
suspension in execution occurs. 

Buffer 

An intermediate storage area used to compensate for a difference in rates of data flow, or 
times of event occurrences, when transmitting data between central memory and an 
external device during input/output operations. 

Byte 

A group of bits. Unless prefixed (for example, a 6-bit byte), the term means 8-bit groups. 
When used for encoding character data, a byte represents a single character. 



Cache 

A high-speed memory that resides in the central processor. 
Cartridge Alternate Storage 

MSE or optical disk used as an alternate storage medium for permanent files. See Alternate 
Storage. 

Cartridge Tape Subsystem (CTS) 

The Control Data 5680 Cartridge Tape Subsystem (CTS) consists of hardware and software 
that allow reading and writing of CTS tapes (IBM 3480-compatible cartridge tapes). An 
operator manually loads and unloads the tapes. Contrast with Automated Cartridge 
Subsystem. 

Cassette 

The magnetic tape device in an NPU used for bootstrap loading of offline diagnostics and (in 
remote NPUs) the bootstrap load/dump operation. 

Catalog Image Record (CIR) 

A record written at the beginning of the archive file on which the permanent files are 
dumped for each incremental dump. When a file is loaded, this CIR information is placed in 
the permanent file catalog of the device being loaded. 

Catalog Track 

A track on a user's master device containing the catalog entries that define and specify the 
location of each permanent file created by that user. Users are assigned by groups to 
catalog tracks according to user index and number of catalog tracks on the master device. 

Catenet 

A collection of network solutions connected using gateways. Abbreviated from concatenated 
network. 
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CCITT 

See Consultative Committee of International Telephone and Telegraph (CCITT). 

CCP 

See Communications Control Program. 

CDCNET 

See CONTROL DATA® Distributed Communications Network. 

CDCNET Operator (COP) 

The administrative operator who resides at either the system console or a terminal and 
controls CDCNET network elements (such as lines, terminals, trunks, and DIs associated 
with CDCNET). 

Central Memory Resident (CMR) 

The low address area of central memory reserved for tables, pointers, and subroutines 
necessary for operation of the operating system. It is never accessible to a user's central 
processor program. The monitor allocates the remainder of central memory to jobs as they 
are selected on a priority basis for execution. 

Channel Number 

The number of the data channel on which a peripheral device controller can be accessed. 

Character 

Unless otherwise specified, references to characters in this manual are to 7-bit ASCII code. 

Charge Number 

An alphanumeric identifier the installation uses to allocate charges to individual users for 
system usage. 

Checkpoint 

The process of writing a copy of your job's central memory, the system information used for 
job control, and the names and contents of all assigned files that are identified in a 
CHECKPT request to a magnetic tape or disk. 

CIO 

See Combined Input/Output 

cm 

See Catalog Image Record. 

CLA 

See Communications Line Adapter. 

CMR 

See Central Memory Resident. 
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CMRDECK 



CMEDECK 



The central memory resident deck that resides on the deadstart file. It defines central 
memory, table sizes, and configuration information not oriented to equipment. 

Coldstart 

Procedure used to deadstart if the tape or disk controller has not yet been loaded with 
controlware, or the controlware is not running. 

Combined Input/Output (CIO) 

A system routine that performs NOS I/O. 

Common Testing and Initialization (CTI) 

Common deadstart process that resides on the deadstart file and the maintenance system 
library. 

Communication Line 

A complete communication circuit between a terminal and its network processing unit. 

Communications Control Program (CCP) 

A portion of the network software that resides in a 255x series network processing unit. 
This software can include routines such as the terminal interface program. 

Communications Line Adapter (CLA) 

Hardware that provides the interface between NPUs and modems. 

Communications Supervisor (CS) 

A portion of the network software written as an application program; the CS coordinates the 
network-oriented activities of the host computer and of the lines and terminals logically 
linked to it. 

COMPASS 

COMPrehensive ASsembly System. The standard assembly language used with CYBER 
180, CYBER 170, CYBER 70, and 6000 Computer Systems. Also, the command used to 
assemble a program written in the COMPASS assembly language. 

Connection Number 

A number assigned to an IAF terminal by the system when the terminal is logged in and an 
entry is made for the job in the executing job table. 

Connection Status 

A job attribute kept in the job's executing job table (EJT) entry. The system uses it to 
determine the job's relationship with IAF. 

Consultative Committee of International Telephone and Telegraph (CCITT) 

(Actually, the Comite Consultif International Telephonique et Telegraphique). An 
organization chartered by the United Nations to develop and publish international 
standards for the communications industry. 
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CONTROL DATA® Distributed Communications Network (CDCNET) 

A catenet system using Control Data Network Architecture, Control Data hardware, and 
Control Data software. 

Control Point 

The portion of central memory that is assigned to a job. When a job is allocated a portion of 
central memory, it becomes eligible for assignment to the central processor for execution. 

Control Point Number 

The number of the control point to which a job is assigned while the job resides in central 
memory. The actual number of control points is an installation parameter. Before the job 
can execute, each central processor program must be assigned to a control point. 

Controller 

Hardware device that connects channels to peripheral devices. For example, a tape 
controller might connect up to eight tape units to one channel. 

Controlling NOP 

An NPU operator (NOP) who is allowed to change the status of network elements (lines, 
logical links, terminals, and trunks) connected to an NPU. 

Controlware 

A special type of software that resides in a peripheral controller. The controlware defines 
the functional characteristics of the controller. 

COP 

See CDCNET Operator. 

CS 

See Communications Supervisor. 

CTI 

See Common Testing and Initialization. 

CTS 

See Cartridge Tape Subsystem. 

D 

DAS 

See Disk Array Subsystem. 
DAT 

See Device Access Table. 
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Data Channel 



One of the 9 to 24 channels (12-bit) by which information passes between the peripheral 
processors and peripheral devices. Refer to Channel Number. 

Data Recording Drive (DRD) 

A component of the 7991 Storage Module. The DRD reads data from and writes data to the 
cartridges. 

Dayfile 

A chronological file created during job execution that forms a permanent accounting and job 
history record. Dayfile messages are generated by operator action or when some commands 
are processed. A copy of the dayfile is printed with the output for each job. The user must 
explicitly request it in an interactive job. 

DDP 

The distributive data path. 
Deadstart 

The process of initializing the system by loading the operating system library programs and 
any of the product set from magnetic tape or disk. Deadstart recovery is reinitialization 
after system failure. 

Deadstart Sequencing 

The execution of a selected set of commands before normal system job scheduling is enabled. 
Debug Log File Processor (DLFP) 

A processor that analyzes trace files produced by the application interface program trace 
utility. 

Destage Dump Tapes 

Tapes that contain files that were destaged from disk using the PFDUMP utility with the 
DT parameter specified. 

Destaging 

The process of creating an alternate storage copy of a file on MSE, tape, or optical disk 
alternate storage. Files are destaged to tape or optical disk alternate storage when the site 
executes PFDUMP with the DT parameter specified. Files are destaged to MSE when the 
site executes SSMOVE with the appropriate parameters specified. 

Detached Job 

An interactive service class job removed from control of the Interactive Subsystem. It may 
or may not continue to execute, depending on the presence of commands in the command 
buffer or an active job step. Control is regained by recovering the EJT entry for the job. 

Device Access Table (DAT) 

A table that contains the logical description (family name/pack name and device number) of 
each disk device (shared or nonshared) that is accessible by any machine in a linked shared 
device multimainframe complex. 
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Device Index Table (DIT) 

A table that is used to determine device usage in an independent shared device 
multimainframe complex. 

Device Interface (DI) 

CDCNET hardware for open system interconnection. The device interface houses processor 
boards in configurations that permit a network of various other data processing equipment. 

Device Mask 

An 8-bit quantity that identifies the group of users who have the particular device as their 
master device; that is, it identifies the device that contains their file catalogs, all their 
indirect access files, and possibly some or all of their direct access files. 

DFD Utility 

A dayfile dumping utility that dumps all or selected parts of the system dayfile to produce a 
listing. 

DFLIST Utility 

A utility that generates a printer listing of all permanent files created by the DFTEKM 
utility. 

DFTERM Utility 

A utility that terminates an active or inactive dayfile and retains it as a direct access 
permanent file for later use. 

DI 

See Device Interface. 

Diagnostic Operator (DOP) 

An NPU operator who resides at a terminal and has permission only to check status and 
test the network. 

Direct Access File 

A NOS permanent file that can be attached to the your job. All changes to this file are made 
on the file itself rather than a temporary copy of the file (compare with Indirect Access File). 

DIS (Job Display) 

A system peripheral processor program similar to the system display (DSD) that provides 
communication between a job in central memory and the operator at the console, and 
permits the operator to control execution of the program through the console keyboard. 

Disabled Job 

An interactive service class job temporarily rolled out due to user break processing or 
encountering the end of its command stream. The job scheduler ignores disabled jobs. 
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Disk Array Subsystem (DAS) 

Disk Array Subsystem (DAS) 

A disk storage subsystem. The 5830 Disk Array Subsystem (DAS) consists of multiple disks 
that are combined to form one logical device in a single cabinet. The disks can be combined 
to increase storage capacity and operational speed as well as to do parity checking. The only 
devices that can be included in DAS are 5832 Solid State Disk (SSD) units, 5833 Sabre 
units, and 5838 Elite units. Refer also to Solid State Disk, Sabre, and Elite. 

Display Code 

A 6-bit character code set that represents alphanumeric and special characters. 
Disposition Code 

A 2-character mnemonic indicating the destination queue and format for processing a file 
named on a ROUTE function. 

dit 

See Device Index Table. 

DLFP 

See Debug Log File Processor. 

DMPNAD 

See Dump NAD Memory. 

DOP 

See Diagnostic Operator. 

Downline 

The direction of output flow, from host to terminal. 

DRD 

See Data Recording Drive. 

DSD (System Display) 

The operating system program that provides communication between the operator and the 
system by accepting control information typed on the console keyboard and by displaying 
information pertinent to all jobs known to the system. DSD is permanently assigned to 
peripheral processor 1. 

DSDI Utility 

A deadstart dump interpreter utility that is called by a batch command to convert selected 
portions of the binary information on an express deadstart dump file into reports to be listed. 

Dump NAD Memory (DMPNAD) 

A utility that reads the NAD memory and formats the data into an output file. 
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E 

ECS 

See Extended Core Storage. 

EDD File 

See Express Deadstart Dump File. 

EDD Utility 

See Express Deadstart Dump Utility. 

EJT 

See Executing Job Table. 

EJT Ordinal 

An index into the executing job table (EJT). It uniquely identifies an EJT entry. The 
acceptable range is from 0001 to 4095. 

ELD Utility 

A dayfile dumping utility that dumps all or selected parts of the error log dayfile to produce 
a listing. 

Elite 

A disk unit that can be configured only as part of the 5830 Disk Array Subsystem (DAS). 
The Elite disk has a formatted capacity of 1759 megabytes and can be configured two 
different ways: as a single unit, or as a single unit with another unit used for partiy. 

End-of-Chain Flag (EOC) 

In an MSE environment, EOC is a flag in the 7990 catalog that identifies the last volume in 
a chain of allocated AUs. 

End-of-File (EOF) 

A boundary within a sequential file, but not necessarily the end of a file that can be 
referenced by name. The actual end of a named file is defined by EOI. For labeled tape, 
EOF and EOI (denoted by the EOF1 label) are the same. For multifile tape files, EOF and 
EOI do not correspond. In the product set manuals, an end-of-file is also referred to as an 
end-of-partition. 

End-of-Information (EOI) 

The end of data on a file. Information appearing after this point is not considered part of 
file data. In card decks, a card with a 6/7/8/9 multiple punch in column 1. On mass storage 
devices, the position of the last written data. On labeled tape, it is the EOFl label. CYBER 
Record Manager defines end-of-information in terms of file residency and organization. 

End-of-Record (EOR) 

An indicator that marks the end of a logical record. Also referred to as end-of-section. 



60459300 U Glossary B-ll 



Entry Point 

Entry Point 

A location within a program or procedure that can be referenced from other programs. Each 
entry point has a unique name with which it is associated. 

EOC 

See End-of-Chain Flag. 

EOF 

See End-of-File. 

EOI 

See End-of-Information. 

EOR 

See End-of-Record. 

EQPDECK 

The equipment description deck used during deadstart to define the system equipment 
configuration. 

Equipment Access Levels 

A range of access levels specified for each equipment on a secured system. In order for a file 
to be stored or output on a given equipment, the file's access level must be within the 
equipment access levels for that equipment. 

Equipment Number 

A number from to 7 that identifies the setting on a peripheral device controller. 
Equipment Status Table (EST) 

A central memory resident table listing all the defined equipments, parameters affecting 
their operation, and the status of the equipments. 

ESM 

See Extended Semiconductor Memory. 

EST 

See Equipment Status Table. 

EST Ordinal 

The number designating the position of an entry within the equipment status table (EST) 
established at each installation. Devices are identified in operator commands by EST 
ordinals. The EST ordinal is sometimes referred to as equipment number. 

Ethernet 

A baseband local area network protocol developed by the XEROX, Intel, and Digital 
Equipment Corporations. CDCNET is an Ethernet-compatible network. 
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Exchange Package 

A table that contains information used during job execution. It is printed as part of the 
output when a job aborts. 

Executing Job Table (E JT) 

A central memory resident table that contains a 4-word entry for all executing jobs including 
interactive service class jobs. It is used to control jobs that are executing at a control point 
and jobs that are rolled out. Every executing job in the system has an EJT entry. 

Execution 

An input job is in execution after it is selected by the operating system and assigned to a 
control point. A job remains in execution until terminated, but it can be temporarily 
swapped or rolled out by the operating system. 

Express Deadstart Dump (EDD) File 

A file that is generated on magnetic tape by the express deadstart dump utility. This file 
contains a dump of memory, executing exchange packages, hardware registers, and 
controller memory. 

Express Deadstart Dump (EDD) Utility 

A utility that may be run at deadstart time after a system malfunction has occurred. It 
generates the express deadstart dump file on magnetic tape. 

Extended Core Storage (ECS) 

A type of extended memory that is an option available for 6000 Computer Systems, CYBER 
70 Computer Systems, CYBER 170 Computer Systems (except model 176), and CYBER 180 
Computer Systems. The maximum size of ECS is two million words. See Extended Memory. 

Extended Memory (EM) 

An additional portion of memory that is available as an option. This memory can be used 
for program and data storage, but not for program execution. Special hardware instructions 
exist for transferring data between central memory and extended memory. Extended 
memory consists of either extended core storage (ECS), extended semiconductor memory 
(ESM), large central memory extended (LCME), or unified extended memory (UEM). 

Extended Memory File Space 

The portion of extended memory that is defined as a mass storage device. 
Extended Memory I/O Buffers 

The portion of extended memory that is used for buffering I/O data to and from disks. Disks 
requiring I/O buffers are: 819, 885-42, 887, 895, and 9853. 

Extended Semiconductor Memory (ESM) 

A type of extended memory that is an option available for 6000 Computer Systems, CYBER 
70 Computer Systems, CYBER 170 Computer Systems (except model 176), and CYBER 180 
Computer Systems. The maximum size of ESM is 16 million words. See Extended Memory. 
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Facility Interface Program (FIP) 

A program consisting of routines and buffers that are loaded into each application program's 
field length. This program is the interface between the application program and RHF. 

Family Device 

A mass storage permanent file device associated with a specific system. A family may 
consist of from 1 to 63 logical devices. Normally, a system runs with one family of 
permanent file devices available. However, additional families may be introduced during 
normal operation. This enables users associated with the additional families to access their 
permanent files via the alternate family. 

Family Name 

Name of the permanent file storage device or set of devices on which all of a user's 
permanent files are stored. When a user requests a permanent file, the system looks for it 
on this family (group) of devices. Usually a system has only one family of permanent file 
devices, but it is possible to have alternate families in the system. At login, the user may 
have to specify which family he/she is using. A user gets a family name from his/her 
employer, instructor, or computer center personnel. 

Family Ordinal Table (FOT) 

A table that maintains the relationship between family ordinals and family names. 

FCT 

See File and Cartridge Table. 

FET 

See File Environment Table. 

Field Length 

The area in central memory allocated to a particular job; the only part of central memory 
that a job can directly access. Also the number of central memory words required to process 
a job. 

File 

A collection of information referred to by a file name (from 1 to 7 alphanumeric characters). 
You can create a file at the terminal or retrieve a file from permanent file storage for use 
during a terminal session. 

File Access Category 

A property of a permanent file used by the creator of the file on a secured system to restrict 
access of the file to a particular group of users. A secured system supports up to 32 access 
categories, and a user is authorized to use some, all, or none of those categories. Refer also 
to System Access Categories. 

File Access Level 

A property of each file on a secured system used to indicate the sensitivity of information 
contained on the file. A file is assigned the current job access level by default when it is 
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File and Cartridge Table (FCT) 

created or stored; the file creator may specify any access level for that file that is within the 
set of access levels valid for the job, the system, the file creator, and (for interactive jobs) 
the communication line to the host mainframe. If a user accesses a file on a secured system, 
that user must be validated for the access level of the file. Refer also to Access Level, Job 
Access Level, and Job Access Level Limits. 

File and Cartridge Table (FCT) 

Table that has an entry for each cubicle assigned to the subfamily from a given SM. 

File Category 

Each permanent file is assigned a category of private, semiprivate, or public. 

File Count 

A maximum number of permanent files allowed each user. 

File Environment Table (FET) 

A table within a program's field length through which the program communicates with 
operating system input/output routines. One FET exists for each file in use by the program. 

File Name Table (FNT) 

A system-managed table that contains the local file name, the file type, and other job 
control information. All active files in the system have an FNT entry. 

File Status Table (FST) 

A system-managed table that contains information peiiaining to the file's location in mass 
storage and other job control information. Each active file in the system has an FST entry. 
See also File Name Table. 

FIP 

See Facility Interface Program. 

First Level Peripheral Processor (FLPP) 

The processor that is connected directly to the CYBER 170 Model 176 mainframe and 
operates synchronously with the mainframe. 

FLPP 

See First Level Peripheral Processor. 

FNT 

See File Name Table. 

Forms Code 

An attribute of output files and output devices. The user can specify special forms required 
for output, and then mount the special forms and use the FORM command to let the system 
process his/her output. 
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FOT 

See Family Ordinal Table. 

FST 

See File Status Table. 

Function Processor 

A system CPU or PP program that the user can call by placing a request in location RA+1. 
Function processors perform input/output, local and permanent file manipulations, and so 
on. 

H 

Hardware Initialization and Verification Software (HIVS) 

The software package that assists CTI during deadstart and provides deadstart 
confidence-level testing (HVS). 

Hardware Verification Sequence (HVS) 

HVS is a member of HIVS. It tests the ability of memory to hold patterns of data and 
execute instructions. The user can choose to test central memory, extended memory, PP 
memory, and central processor memory. 

Head-of-Chain Flag (HOC) 

In an MSE environment, HOC is a flag in the 7990 catalog that identifies the first volume 
in a chain of allocated AUs. 

Header 

A word or set of words at the beginning of a block, record, file, or buffer that contains 
control information for that unit of data. 

HIVS 

See Hardware Initialization and Verification Software. 

HOC 

See Head-of-Chain Flag. 

HOP 

See Host Operator. 

Host 

The computer that controls a network, executes the application programs, and processes 
network messages. 

Host Operator (HOP) 

The administrative operator who resides at the system console, initiates NAM, and controls 
NPUs and network related host elements. 
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HVS 

See Hardware Verification Sequence. 

I 

IAF 

See Interactive Facility. 

Inactive Queued File Table (IQPT) 

A table of file entries that has been removed from the queued file table. An IQFT file is on 
each mass storage device on which one or more inactive queued files reside. 

Incremental Dump 

An incremental dump copies those permanent files modified after a specified date. Each 
incremental dump writes a catalog image record at the beginning of the archive file on 
which the permanent files are dumped. 

Incremental Load 

An incremental load builds up an accumulation of the most recently modified versions of the 
files extracted from the archive files for loading. A series of archive files is read in reverse 
order of creation. The CIR is read and checked against the archive files. If a file matches an 
entry on the CIR, that file is a candidate for loading. 

Indirect Access File 

A NOS permanent file that you access by making a temporary copy of the file (GET or OLD 
command). You create or alter it by saving or substituting the contents of an existing 
temporary file (REPLACE or SAVE command). 

Input File 

The system-defined file that contains the entire job the user submits for processing. It is 
also known as the job file. 

Input/Output Unit (IOU) 

A collection of all PPs, PP channels, and related hardware for models 865 and 875 and 
CYBER 180-class machines. 



Interactive Facility (IAF) 

An application that provides a terminal operator with interactive processing capability. The 
Interactive Facility makes terminal input/output and file input/output appear the same to 
an executing program. 

Interactive Transfer Facility (TTF) 

A network application that allows the user to connect an interactive terminal to a remote 
CYBER 200 computer system linked to a host mainframe by a loosely coupled network. 

IOU 

See Input/Output Unit. 
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IQFT 

IQFT 

See Inactive Queued File Table. 

ITF 

See Interactive Transfer Facility. 

J 

Job Access Level 

On a secured system, each job has an access level. This is the default access level that is 
assigned to files that are created or stored in the job. A job's initial access level is the lower 
access level limit for the job. The job's access level is automatically raised to the access level 
of any file from which information is read. The user can also change the job access level. 
Refer also to Job Access Level Limits. 

Job Access Level Limits 

An upper limit and a lower limit that determine the range of access levels that are valid for 
a particular job on a secured system. All files used in a given job must have an access level 
within the job's access level limits. 

Job Sequence Name ( JSN) 

The unique, system-defined name assigned to every executing job or queued file. The JSN is 
a string of four alphabetic characters. 

Job Status 

A job attribute kept in the job's executing job table (EJT) entry. It is used by the system to 
determine if a job is rolled in or rolled out. If the job is rolled out, job status indicates why 
it was rolled out. 

JSN 

See Job Sequence Name. 



LAN 

See Local Area Network. 

Large Central Memory Extended (LCME) 

A type of extended memory that is an option available for model 176. Refer to Extended 
Memory. 

LCF 

See Local Configuration File. 

LCME 

See Large Central Memory Extended. 
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LCN 

See Loosely Coupled Network. 

LDLIST Utility 

A utility that generates a printer listing of queued files present on a dump tape produced by 
the QDUMP utility. 

LFG 

See Load File Generator. 

LID 

See Logical Identifier. 

LISTPPM Utility 

A PIP dump analyzer program that converts all available PIP dump binary records on the 
PIP memory dump file into a report to be listed in byte format. 

Load File Generator (LFG) 

A utility program that reformats communications control program files for subsequent use 
by the network supervisor of NAM to load network processing units. 

Load Point 

Metallic strip marking the beginning of the recordable portion of a magnetic tape. Data, 
including labels, is written after the load point. A rewind positions a single file volume to 
the load point. 

Load Sequence 

A sequence of load operations that encompasses all of the loader's processing from the time 
that nothing is loaded until the time execution begins. It includes initialization, 
specification of specified loader requests, and completion of load. 

Local Area Network (LAN) 

A privately owned network that interconnects data processing equipment to provide 
high-speed communications. It allows users and services to exchange messages and share 
resources. 

Local Batch Job 

A batch job submitted at the central computer site through a card reader or terminal. 
Local Configuration File (LCF) 

A file in the host computer system containing information on the logical makeup of the 
communication elements of the host. The file contains a list of the application programs 
available for execution in the host computer, and the users that can access it. This is a NOS 
direct access permanent file. 
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Local File 

Any file that is currently associated with a job. Local files include all temporary files and 
attached direct access files. 

Local File Name 

The file name assigned to a file while it is local (assigned) to a job. The name is contained in 
the local file name table. 

Local NAD 

A 380-170 NAD connected to the host mainframe using a channel and configured in the EST. 
Local NPU 

An NPU that is connected to the host via a coupler. A local NPU always contains a host 
interface program for processing block protocol transfers across the host/local NPU interface. 

Logical Identifier (LID) 

A 3-character alphanumeric string used to identify a particular ma infr ame. LIDs are 
identified by the user's site. 

Loosely Coupled Network (LCN) 

A network of physically connected computer systems. The LCN environment allows jobs, 
data files, and messages to be transmitted from one computer system to another. 

M 

Machine Identification (MID) 

The identifier that associates a specific machine with its access to a shared device. 

Machine Recovery Table (MRT) 

A table that provides the information needed to recover the mass storage space and 
interlocks of a machine that shares a mass storage device. 

Machine Recovery Utility (MREC) 

A utility that clears interlocks held by the machine to be deadstarted that have not been 
cleared by CPUMTR. It also recovers mass storage space on a shared device that is 
currently not accessible because of a machine interruption. 

Macro 

A sequence of source statements that is saved and then assembled whenever needed 
through a macro call. 

Mainframe Device Interface (MDI) 

A device interface that is configured to connect a CYBER mainframe to Ethernet. 

Mainframe to Terminal Interface (MTI) 

A terminal interface that is configured to connect a CYBER mainframe to a terminal for 
support of terminal-to-network communications. 
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MAINLOG Utility 

MAINLOG Utility 

A dayfile dumping utility that dumps all or selected parts of the binary maintenance log to 
produce an output file in binary format. 

Maintenance Logging Transfer Utility (MLTF) 

A utility that controls logging NAD error logs into the binary maintenance log. 

Maintenance Register 

A hardware register used in error detection, logging, and recovery procedures. Maintenance 
registers are used on models 865 and 875 instead of status/control registers. Refer to 
Status/Control (S/C) Register. 

MAP 

The Matrix Algorithm Processor. 
Mass Storage Device 

An extended memory or disk unit that has defined logical attributes such as family, file 
residency, and so on. 

Mass Storage Extended Subsystem (MSE) 

MSE is the product consisting of the 7990 hardware, the channel interface, the diagnostics, 
and the operational software. MSE stores data on the 7990 and moves it to disk upon 
request for access by an authorized user. 

Mass Storage Table (MST) 

A table that contains an entry for each logical device in the configuration of mass storage 
devices currently available to the system. 

Master Device 

A disk device that contains the user's permanent file catalog entries; all of the user's 
indirect access files; and all, part, or none of the user's direct access files. 

MCT 

See Memory Control Table. 

MDI 

See Mainframe Device Interface. 

MID 

See Machine Identification. 

Memory Control Table 

A central memory table used in allocating central memory and extended memory to user 
jobs. 
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MLIA 

See Multiplex Loop Interface Adapter. 

Monitor 

The system routine that coordinates and controls all activities of the computer system. It 
occupies peripheral processor and part of central memory. It schedules the use of the 
central processor and the other peripheral processors. 

MREC 

See Machine Recovery Utility. 

MRT 

See Machine Recovery Table. 

MSE 

See Mass Storage Extended Subsystem. 

MST 

See Mass Storage Table. 

MTI 

See Mainframe to Terminal Interface. 

Mnltimainframe Operation 

An operation that provides mechanisms by which more than one computer can share mass 
storage devices. 

Multiplex Loop Interface Adapter (MLIA) 

The hardware portion of the multiplex subsystem that controls the multiplex loops (input 
and output) as well as the interface between the NPU and the multiplex subsystem. 

Multispindle Device 

A logical mass storage device that includes from two to eight disk units. 

Multiterminal Job 

A job that does one specific task for many terminals while being scheduled into the system 
only once. 

N 

NAD 

See Network Access Device. 

NAM 

See Network Access Method. 



B-22 NOS Version 2 Analysis Handbook 60459300 U 



NCF 



NCF 

See Network Configuration File. 

NCTF 

See Network Description File. 

NDA 

See NPU Dump Analyzer. 

NDI 

See Network Device Interface. 

NDL Processor 

See Network Definition Language Processor. 

NDR 

See Network Driver. 

Negative Field Length (NFL) 

Central memory assigned to a control point that physically precedes the job's reference 
address (EA). 

NETLOG 

A program that uses the network configuration file to determine which remote NADs should 
be logged. 

NETOU 

See Network Operator Utility. 
Network 

An interconnected set of network elements consisting of a host and one or more NPUs and 
terminals. 

Network Access Device (NAD) 

The primary element in a loosely coupled network. Each NAD connects a computer system 
to the network. 

Network Access Method (NAM) 

A software package that provides a generalized method of using a communications network 
for switching, buffering, queuing, and transmitting data. NAM is a set of interface routines 
used by a terminal servicing facility for shared access to a network of terminals and other 
applications, so that the facility program does not need to support the physical structures 
and protocols of a private communication network. 

Network Configuration File (NCF) 

A network definition file in the host computer containing information on the network 
elements and permissible linkages between them. The status of the elements described in 
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this file is modified by the NPU operator in the course of managing the network. This is a 
NOS direct access permanent file. 

Network Definition Language (NDL) Processor 

The network software module that processes an NDL program as an offline batch job to 
create the network definition files and other NDL program output. 

Network Description File (NCTF) 

A file that must be present if the Transaction Facility is used. The file is prepared by the 
site analyst. 

Network Device Interface (NDI) 

A device interface that is configured to transfer data between networks; for example, LAN 
to LAN, LAN to PDN, PDN to PDN, or LAN to communication lines. 

Network Driver (NDR) 

A program that executes in a dedicated peripheral processor unit. It communicates with the 
network access devices using a host computer data channel, and is the interface between 
RHF and the communication network. 

Network Invocation Number (NIN) 

A 1- to 3-digit decimal number. NIN is incremented by 1 every time NAM is brought up. 

Network Load File (NLF) 

An output file generated by the load file generator utility for use by the network supervisor. 

Network Operator Utility (NETOU) 

A group of programs residing in a host computer and in a mainframe device interface 
connected to the mainframe that allow a network operator to access, monitor, control, and 
configure a CDCNET network from the host console or a remote terminal. NETOU allows 
commands from network operators to be sent through the CDCNET network to specific 
device interfaces or all of the DIs in the network. 

Network Processing Unit (NPU) 

The collection of hardware and software that switches, buffers, and transmits data between 
terminals and host computers. 

Network Supervisor (NS) 

A portion of the network software written as a NAM application program. NS dumps and 
loads NPUs upon request. 

Network Terminal 

A terminal that communicates with the operating system through the network. 

Network Validation Facility (NVF) 

A portion of the network software, written as a NAM application program. The network 
validation facility performs application validation and all connection validation processing 
and supports login dialog with the terminal user. 
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NFL 

See Negative Field Length. 

NIN 

See Network Invocation Number. 

NLF 

See Network Load File. 

Nonincremental Load 

A nonincremental load does no CIR checking and uses only parameter options specified on 
the PFLOAD call, if any, to select candidates for loading. 

NOP 

See NPU Operator. 

NPU 

See Network Processing Unit. 

NPU Dump Analyzer (NDA) 

A utility program that produces a readable printout from the NPU dump files. 

NPU Operator (NOP) 

The administrative operator who resides at a terminal and controls NPUs. 

NS 

See Network Supervisor. 

NVF 

See Network Validation Facility. 

o 

Object Code 

The machine language version of a program that has been translated (compiled) from source 
code written in a higher-level language. 

Operating System 

The set of system programs that controls the execution of computer programs and provides 
scheduling, error detection, input/output control, accounting, compilation, storage 
assignment, and other related services. 

Optical Disk Alternate Storage 

Optical disk used as an alternate storage medium for permanent files. The optical disk 
units may be housed in a jukebox. See Alternate Storage. 
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Origin Type 

A job attribute that indicates how a job entered the system. The four origin types are 
interactive origin, batch origin, remote batch origin, and system origin. 

Output File 

The system-defined file that contains the output from job processing. It is also known as the 
print or punch file. 



PACKER Utility 

A utility that provides the capability to manage the holes within the indirect access 
permanent file chain on a permanent file device. 

Paging (Screen) 

The process of filling a CRT display with data and holding additional data for subsequent 
displays. Changing the page display is an operator-controlled function if the page-wait 
option is selected. 

Parity 

In writing data, an extra bit is either set or cleared in each byte so that every byte has 
either an odd number of set bits (odd parity) or an even number of set bits (even parity). 
Parity is checked on a read for error detection and possible recovery. 

Partial Dump 

A partial dump copies permanent files according to any specified options, except those 
defining a full or incremental dump. 

Password 

A name or word the user enters during login to provide extra security for his/her user name. 
A unique password ensures that no one else can log into the system with someone else's 
user name and access that user's files. A user's password is given to him/her by that user's 
employer, instructor, or computer center personnel. 

PCP 

See Pseudo-control Point. 

PDN 

See Public Data Network. 

Peripheral Interface Package (PIP) 

The interface package between the PPU of the CYBER computer and the network 
application. 

Peripheral Processor (PP) 

The hardware unit within the host computer that performs physical input and output 
through the computer's data channels. 
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Peripheral Processor Unit (PPU) 

First level peripheral processor. A PPU is contained in the mainframe in a multimainframe 
environment and operates synchronously with the mainframe. Sometimes referred to as 
FLPP. 

Permanent File 

A mass storage file that is cataloged by the system so that its location and identification are 
always known to the system. Permanent files cannot be destroyed accidentally during 
normal system operation. They are protected by the system from unauthorized access 
according to privacy controls specified when they are created. 

Permanent File Catalog Entry (PFC) 

A 16-word entry that the system maintains and uses to determine the file name, owner, 
identification, disk pointers, alternate storage pointers, and other attributes of a permanent 
file. 

Permanent File Family 

The permanent files that reside on the family devices of a specific system. 

Permanent File Manager (PFM) . 

PFM identifies the master device and catalog track information when a user submits a job. 

Permanent File Supervisor (PFS) 

The PFS processes parameters in utility commands and loads the correct processing 
overlays. 

Permanent File Transfer Facility (PTF) 

PTF is an application program initiator started by the user using an MFLINK command. It 
is responsible for initiating and completing (with the help of its servicing application, PTFS 
on another host) a permanent file transfer. 

Permanent File Transfer Facility Servicer (PTFS) 

PTFS is an application program servicer started by RHF or NAM when requested by a PTF 
on another host. The PTFS application assists the PTF application in completing the file 
transfer by performing those permanent file functions requested by the user and then 
transferring the file between PTF and PTFS. 

Permanent File Utility (PFU) 

A utility that manages the catalogs, permits, data allocation on a device, and the data 
transfer between the device and the overlay. 

Permission Mode 

A mode of operation that a user is allowed for a particular permanent file, such as write, 
modify, append, read, and so forth. 

PFATC Utility 

A utility that produces a cataloged directory of file information derived from an archive file 
previously created by the PFDUMP utility. 
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PFC 

See Permanent File Catalog. 

PFCAT Utility 

A utility that produces a cataloged directory of file information derived from catalog tracks 
on a master device. 

PFCOPY Utility 

A utility that extracts files from an archive file and copies them to one or more files at a 
control point. 

PFDUMP Utility 

A utility that dumps permanent files to an archive file. Dumps can be reloaded by the 
PFLOAD utility and can be accessed by the PFATC and PFCOPY utilities for cataloging 
and copying. 

PFLOAD Utility 

A utility that loads archived files produced by the PFDUMP utility back into the permanent 
file system. The load can reestablish the permanent file system exactly as it was at the time 
of the dump, or can load only a desired subset of files on the archive file. 

PFM 

See Permanent File Manager. 

PFREL Utility 

A utility that releases disk space for permanent files that have copies on alternate storage. 

PFS 

See Permanent File Supervisor. 

PFU 

See Permanent File Utility. 

Physical Identifier (PID) 

The unique 3-character identifier of a specific host. 

Physical Record Unit (PRU) 

The amount of information transmitted by a single physical operation of a specified device. 
For mass storage files, a PRU is 64 central memory words (640 characters); for magnetic 
tape files, the size of the PRU depends upon the tape format. A PRU that is not full of user 
data is called a short PRU; a PRU that has a level terminator but no user data is called a 
zero-length PRU. 

PICB 

See Program Initiation Control Block. 
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PID 

See Physical Identifier. 

PEP 

See Peripheral Interface Package. 

PP 

See Peripheral Processor. 

PPS 

The Peripheral Processor Subsystem. 

PPU 

See Peripheral Processor Unit. 

Preserved File 

A mass storage file that is recovered on all levels of system deadstart. Preserved files 
include permanent files, queued files, and system dayfiles. 

Primary File 

A temporary file created with the OLD, NEW, LIB, (interactive jobs only), or PRIMARY 
command. The primary file is assumed to be the file on which most system operations are 
performed unless another file is specified. There can be only one primary file associated 
with your job. 

Primary VSN 

The volume serial number (VSN) of a single volume destage dump tape or the VSN of the 
first of volume a multivolume set of destage dump tapes. The VSN must be two 
alphanumeric characters followed by a four-digit decimal number; the number must be in 
the range 0000 through 4095. 

Privileged Analyst 

A user with AW=CPAM validation (refer to the NOS Version 2 Administration Handbook 
for information on MODVAL validation). Such a user can read system status information 
(such as the system dayfile, account file, and error log) using a nonsystem-orighi job if 
PRIVILEGED ANALYST MODE is enabled (via IPRDECK or DSD command). Note that 
PPJVILEGED ANALYST MODE cannot be enabled on a secured system. 

PROBE Utility 

A utility that traps and measures particular interval events in the system. PROBE 
generates a report from the data collected by the system. 

Procedure 

A user-defined set of instructions that can be referenced by name. The instructions consist 
of procedure directives and system commands. 
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Program Initiation Control Block (PICB) 

Program Initiation Control Block (PICB) 

A sequence of commands that initiates NPU load and dump operations for a specific NPU 
variant. Several PICBs may exist on the network load file. Each PICB is a separate record 
with a unique NPU variant name as its record name. 

Programmable Format Control 

Spacing and format control for 580 line printers provided by the use of software and a 
microprocessor instead of a carriage control format tape. 

Project Number 

An alphanumeric identifier that may be required at a user's installation for accounting and 
billing to a specific project. If it is required, the project number is entered during the login 
procedure. It is given to the user by personnel at his/her installation. 

Protocol 

A set of conventions or rules that must be used to achieve complete communication between 
entities in a network. A protocol can be a set of predefined coding sequences such as the 
control byte envelopes added to or removed from data exchanged with a terminal; a set of 
data addressing and division methods, such as the block mechanism used between an 
application program and NAM; or a set of procedures used to control communication, such 
as the supervisory message sequences used between an application program and NAM. 

PRU 

See Physical Record Unit. 
Pseudo A Register 

A software register used by DSD to function channels and to manipulate peripheral 
hardware devices from the operator's console. 

Pseudo-control Point (PCP) 

The portion of central memory that is assigned to a job that has been pseudo-rolled. 
Pseudo-control points are the same as control points except that a job at a pseudo-control 
point cannot have any activity (such as PP assignment or CPU assignment). 

Pseudo-control Point Number 

The number of the pseudo-control point to which a job is assigned while the job resides in 
central memory. The actual number of pseudo-control points is an installation parameter. 

Pseudo-rollout 

The removal of jobs from a control point to a pseudo-control point so that the control point 
and central memory can be assigned to another job. A job is rolled out to a pseudo-control 
point when its control point is needed by a higher priority job. 

Pseudo-rollin 

The return of jobs from a pseudo-control point to a control point. 

PTF 

See Permanent File Transfer Facility. 
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PTFS 

See Permanent File Transfer Facility Servicer. 

Public Auxiliary Device 

An auxiliary device that is available for access by all validated users knowing the correct 
pack name. Additional validation is required to create or replace files on an auxiliary device. 

Public Data Network (PDN) 

A commercial packet-switching network that supports the interface described in the CCITT 
protocol X.25. 

Q 

QALTER Utility 

A utility that displays, lists, and/or alters routing and other information about active 
queued files. It selects files for processing according to specified criteria. QALTER can also 
purge selected files from the system. 

QDUMP Utility 

A utility that dumps selected queued files from a single device, a family of devices, or all 
devices on the system. These queued files can be dumped either to a tape or disk. QDUMP 
also provides a listing of all files dumped with information about each file processed. 

QFSP 

See Queue File Supervisor Program. 

QFT 

See Queued File Table. 

QFTLIST Utility 

A utility that displays and/or lists routing and other information about active queued files. 
Its operation is similar to that of QALTER, except file alteration or purging is not allowed. 

QLIST Utility 

A utility that lists inactive queued files, which may include all inactive queued files in the 
system or a selected subset based on options specified when the utility is called. 

QLOAD Utility 

A utility that processes the dump files generated by QDUMP or other utilities using the 
same format. QLOAD can selectively load the queued files from these dump files. QLOAD 
can also list the contents of a dump file without loading any files. 

QMOVE Utility 

A utility that moves queued files from one disk device to another. It also produces a listing 
of all files moved with information about each file processed. 
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QREC Utility 

A utility that deactivates or activates selected queued files and purges selected inactive 
queued files. 

QTF 

See Queue File Transfer Facility. 

QTFS 

See Queue File Transfer Facility Servicer. 

Queue File Supervisor Program (QFSP) 

A program that provides control for the queue file utilities. 

Queue File Transfer Facility (QTF) 

QTF is an application program initiator that periodically scans the I/O queues searching for 
files to transfer. When it finds a file to transfer, it initiates and completes the queue file 
transfer with the help of its servicing application, QTFS, on another host. 

Queue File Transfer Facility Servicer (QTFS) 

QTFS is an application program servicer started by RHF or NAM when requested by a QTF 
on another host. The QTFS application assists the QTF application in completing the 
transfer by receiving the queue file and placing it in the I/O queue. 

Queue Priority 

An attribute associated with input and output files. If all other factors are equal, queue 
priority is used to select the best file for processing. 

Queued File 

An input, print, plot, or punch file that has an entry in the QFT, is not assigned to an EJT 
entry, and is waiting to be selected for processing. 

Queued File Table (QFT) 

A central memory resident table that contains a 4-word entry for all active input and output 
queue files. 

R 

Random Access 

An access method by which any record in a file can be accessed at any time. Random access 
applies only to mass storage files with an organization other than sequential. Refer to 
Sequential Access. 

RCFGEN 

See RHF Configuration File Generation. 
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RCL 

See Resident Central library. 

RDF 

See Release Data File. 

Recall 



The state of a program when it has released control of the central processor until a fixed time 
has elapsed (periodic recall) or until a requested function is completed (auto recall). Recall 
is a system action request as well as an optional parameter of some file action requests. 

Record 

A unit of information. In CYBER Record Manager and its language processors, a record is a 
unit of information produced by a single read or write request. 

Eight different record types exist within CRM. The user defines the structure and 
characteristics of records within a file by declaring a record format. 

Regulation Level 

A number that indicates to NAM the existence of a logical link and indicates what types of 
information exchange are possible on that logical link. 

Release Data File (RDF) 

A file created by PFDUMP that identifies those 7990-resident files that are pointed to by 
PFC entries at the time of the dump. 

Remote Batch Job 

A job submitted from a remote batch terminal. 
Remote Host Facility (RHF) 

A central processor program that executes at a system control point. It performs data 
buffering and switching, and is the intermediary between application programs and the 
network. 

Remote NAD 

Any 380 NAD accessible to a local NAD using a loosely coupled network trunk. 

Remote NPU 

A network processing unit finked to a host computer through other network processing units. 

Removable Device 

A disk storage device that can be physically detached from the disk drive. 
Resident Central Library (RCL) 

An area in central memory resident that central library routines specified by the *CM 
directive reside. 
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Resident Peripheral Library (RPL) 

An area in central memory resident that peripheral library routines specified by the *CM 
directive reside. 

RHF 

See Remote Host Facility. 

RHF Configuration File Generation (RCFGEN) 

A utility that reads configuration definition statements to create a permanent file that RHF 
uses for the network description and access. 

Rollout 

The removal of jobs from central memory to mass storage before execution is complete, so 
the control point and central memory can be assigned to another job. A job is rolled out 
when it is waiting for an external event, when its control point and/or central memory is 
needed by a higher priority job, or when it exceeds its central memory time slice. 

Rollout File 

A file containing a job (and system information) that has been temporarily removed from 
the main processing area of the system. 

RPL 

See Resident Peripheral Library. 



Sabre 

The 5833 Sabre is a disk unit that can be configured only as part of the 5830 Disk Array 
Subsystem (DAS). The Sabre disk has a formatted capacity of 1039 megabytes. It can be 
configured in four ways: 

• As a single unit 

• As a single unit with another unit used for parity 

• As a pair of units driven in parallel 

• As a pair of units driven in parallel with another unit used for parity 
Parallel units increase the device's size and speed. 

SC 

See Service Class. 

S/C Register 

See Status/Control Register. 

Scheduling Priority 

An attribute associated with an executing job available for job scheduling. Scheduling 
priority is used to select the best executing service class job for processing. 
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SCOPE 2 Station Facility (SSF) 

A NOS subsystem that allows a NOS user to submit jobs (including batch jobs that require 
interactive I/O) to a linked SCOPE 2 system. The submitted job uses standard SCOPE 2 
commands to access NOS files stored on the originating NOS system. 

SCP 

See Subcontrol Point. 

Screen Management Facility (SMF) 

A subsystem that alters the performance characteristics of the Full Screen Editor (FSE). 
The absence or presence of SMF is not detectable by the FSE user. Performance can be 
optimized by disabling SMF for small mainframes and interactive work loads, and by 
enabling SMF for large configurations and heavy work loads. 

SCRSIM 

See Status/Control Register Simulator. 

SDF 

See System Deadstart File. 

SECDED 

See Single Error Correction Double Error Detection. 

Secondary Mask 

An 8-bit quantity used to identify groups of users who can place direct access files on a 
particular device. 

Secondary VSN 

The VSN of a single volume destage dump tape or the VSN of the first volume of a 
multivolume set of destage dump tapes having a sequence number (the last four characters 
of the VSN) in the range 5000 through 9095. The existence of a secondary VSN assumes the 
existence of a primary VSN having the same two-character prefix and a sequence number of 
5000 less. The primary and secondary VSN tapes or multivolume sets of tapes are assumed 
to contain identical data, although the individual volumes of multivolume sets cannot be 
assumed to be identical. 

Secured System 

A system in which a mandatory security mechanism has been enabled during deadstart. A 
secured system protects information by enforcing restrictions based on access levels and 
access categories, and restricts many sensitive system functions to security administrators. 

Security Administrator 

A secured system prevents users and operators from performing certain functions that could 
result in the unauthorized disclosure or modification of information. These functions can 
only be performed by someone who is designated a security administrator. A security 
administrator is always authorized to access the highest level of information stored on the 
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system. This person performs functions in the areas of installation, user validation, system 
operation, and system maintenance. 

Security Unlock Status 

This status of the system console applies only to a secured system and must be set by a 
security administrator. The console must be in security unlock status in order for the 
security administrator to perform certain functions that are restricted on a secured system. 

Sequential Access 

A method in which only the record located at the current file position can be accessed. Refer 
to Random Access. 

Sequential (SQ) File 

A file in which records are accessed in the order in which they occur. Any file can be 
accessed sequentially. 

Service Class (SC) 

An attribute associated with a queued file or executing job. The service class determines 
how the system services the job. 

SFS 

See Special File Supervisor. 

Single Error Correction Double Error Detection (SECDED) 

A hardware technique that detects and corrects single bit errors in memory. Double bit 
errors are detected by not corrected. 

SM 

See Storage Module. 

SMMap 

See Storage Module Map. 

SMF 

See Screen Management Facility. 

Solid State Disk (SSD) 

The 5832 Solid State Disk (SSD) is a disk unit that can be configured only as part of the 
5830 Disk Array Subsystem (DAS). The SSD has a formatted capacity of 165 megabytes. It 
can be configured in DAS as single units or as pairs of units driven in parallel. Parallel 
units increase the device's size and speed. 

Source Code 

Code input to the computer for later translation into executable machine language 
instructions (object code). 
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Special File Supervisor (SFS) 

A program that provides routines, table management, data manipulation, and I/O 
processing for special system jobs. 

SQFile 

See Sequential File. 

SRU 

See System Resource Unit. 

SSALTER Utility 

A utility that displays the current 7990 hardware configuration and allows an analyst to 
change the status of certain elements in the 7990 configuration. 

SSBLD Utility 

A utility that processes statements consisting of 7990 component-oriented mnemonics that 
define the logical mapping within the 7990 configuration. SSBLD generates a direct-access 
permanent file which SSEXEC uses as its unit device table. 

SSDEBUG Utility 

A utility that allows an analyst to update appropriate entries in the SM maps and/or 7990 
catalogs and thereby resolve inconsistencies reported by the SSVAL utility. SSDEBUG can 
also be used to copy data from selected 7990 files or cartridges to disk. 

SSD 

See Solid State Disk. 
SSDEF Utility 

A utility that creates the system files (SM maps and 7990 catalogs) that are necessary for 
MSE processing. 

SSEXEC Program 

The main processing program that controls MSE activities, such as destaging files from disk 
to the 7990, purging unneeded 7990 files, labeling or relabeling cartridges, updating SM 
maps, and updating 7990 catalogs. 

SSF 

See SCOPE 2 Station Facility. 

SSLABEL Utility 

A utility that manages cartridge assignment and cubicle allocation in a storage module. 

SSMOVE Utility 

A utility that manages disk and 7990 residence. SSMOVE determines which files to leave 
on disk, which files to release from disk and move to 7990, and which files should reside 
both on disk and on 7990. 
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SSSLV Program 

A program that runs on each slave mainframe and communicates with the SSEXEC 
program to retrieve files from the 7990 in response to ATTACH requests by jobs running on 
the slave mainframes. 

SSUSE Utility 

A utility that reads data in the 7990 catalogs and SM maps and produces reports on the 
availability of space on 7990 cartridges and the allocation of cubicle space within an SM. 

SSVAL Utility 

A utility that either performs release processing or reports on problems with the current 
MSE system files. 

Staging 

The process of restoring file data to disk residence from a copy on alternate storage. Staging 
is initiated when a user executes an APPEND, ATTACH, GET, or OLD command for a file 
that is not currently disk resident. 

Status 

Information relating to the current state of a device, line, and so forth. Service messages 
are the principal carriers of status information. Statistics are a special subclass of status. 

Status/Control Register Simulator (SCRSIM) 

A program that enables the user to set status/control register bits in order to aid in the 
testing of error logging and error recovery procedures. 

Status/Control (S/C) Register 

A hardware register used in error detection, logging, and recovery procedures. This register 
is present on all CYBER 170 Computer Systems. For models 865 and 875, the S/C register 
is replaced by a maintenance register. Refer to Maintenance Register. 

Step Mode 

A protected or debugging mode for the operating system monitor. The keyboard spacebar 
must be pressed to process each PP request. 

Stimulator 

A collection of central memory and peripheral processor programs that enters a hypothetical 
work load into the system to analyze the effects of such a load on response time and system 
reliability. 

Storage Module (SM) 

An MSE hardware unit that houses up to 312 usable data cartridges, a cartridge accessor 
unit that picks cartridges from and puts cartridges in their cubicles, and one or two data 
recording drives. 

Storage Module (SM) Map 

A direct access permanent file that contains information indicating the cartridges that 
reside in the SM. 
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Subcontrol Point (SCP) 

A division of a central memory control point. You can set up a control point to contain two 
or more programs; one of the programs is the executive, and monitors the other programs 
executing at the subcontrol points. 

Subfamily 

Each permanent file family consists of eight subfamilies, subfamily through subfamily 7. 
The lower 3 bits of the user index identify the subfamily to which a user belongs. 

Suspended Job 

An interactive job placed in a inactive state. Processing is stopped immediately and 
recovery information is copied to the rollout file. Processing is resumed as if no interruption 
took place, if the job's EJT entry is recovered. 

System Access Categories 

On a secured system, a set of access categories are set during level deadstart. This set 
may consist of some, all, or none of the 32 possible access categories. While the system is 
r unnin g in security mode, you may only use access categories that are within the set of 
system access categories. 

System Access Levels 

On a secured system, a range of access levels is set during level deadstart. This range 
may contain some or all of the eight possible access levels. While the system is running, 
users may only use access levels that are within the range of system access levels. 

System Deadstart File (SDF) 

A file that is a copy of the deadstart tape that resides on a disk storage deadstart device. 
When the system is deadstarted from disk, this file is read to generate copies of the runnin g 

system. 

System Library (SYSTEM) 

The collection of tables and object language programs that reside in central memory or on 
mass storage and are necessary for running the operating system and its product set. 

System Origin Job 

A job entered at the system console. 
System Resource Unit (SRU) 

A unit of measurement of system usage. The number of SRUs includes the central processor 
time, memory usage, and input/ output resources used for a given job. 



TAF 

See Transaction Facility. 
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Tape Alternate Storage 

Magnetic tape used as an alternate storage medium for permanent files. See Alternate 
Storage. 

TCU 

See Trunk Control Unit. 

TDI 

See Terminal Device Interface. 

Temporary File 

A file associated with a job that is not a permanent file. Temporary files no longer exist 
when the user logs off the system or releases the files. 

Terminal Device Interface (TDI) 

A device interface that is configured to support terminal-to-network communications. 
Timed/Event Rollout 

A condition in which an executing job has been temporarily removed from central memory 
but will be rolled back into central memory when a specified event (such as a file is no 
longer busy) or a specified time period has elapsed. 

TRACER Utility 

A utility that monitors the system's activity and gathers data periodically for statistical 
analysis of the system. 

Track Link 

An address of the next track that is a logical continuation of a file. 

Track Reservation Table (TRT) 

A table that describes the physical layout of data on a device and is the key to allocating 
information on the device. 

Transaction Facility (TAF) 

An application program that provides the transaction terminal with access to a data base. A 
terminal using TAF can enter, retrieve, and modify information in the data base. 

TRT 

See Track Reservation Table. 

Trunk 

The communication line connecting two network processing units. 

Trunk Control Unit (TCU) 

The hardware part of a network access device (NAD) that interfaces with a network trunk. 
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u 

UDT 

See Unit Device Table. 

UEM 

See Unified Extended Memory. 

Unified Extended Memory (UEM) 

A type of extended memory that is available as an option for CYBER 180-class machines 
and models 865 and 875. UEM differs from other types of extended memory in that it is a 
portion of central memory and not a separate memory unit. See Extended Memory. 

Unit Device Table (UDT) 

A table that defines the logical mapping of the components within a 7990 configuration. 

Unit Number 

The setting of a hardware device. The unit number is used when more than one hardware 
unit can be connected to a controller. 

Unsecured System 

A system in which the multilevel security mechanism has not been enabled during 
deadstart. The restrictions based on access levels and access categories are not enforced on 
an unsecured system. 

Upline 

The direction of input flow from terminal to host. 

User Break 1 Sequence 

The character or sequence of characters that causes an executing program to be interrupted 
(also called the interruption sequence). 

User Break 2 Sequence 

The character or sequence of characters that causes an executing program to be terminated 
(also called the termination sequence). 

User Index 

A unique 17-bit identifier that is associated with each user name. The user index is used by 
the permanent file manager to identify the device and catalog track for the user's 
permanent files. 

User Job Name (UJN) 

A 1- to 7-character alphanumeric name you specify to replace the system defined JSN for a 
queued file or executing job. 
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User Name 



A name given to the user by his/her employer, instructor, or computer center personnel. A 
user name has certain resources and privileges assigned to it. When logging in to the 
system, a user specifies his/her user name as identification, so that it knows that this 
person is an authorized user and what resources this user is entitled to use. A user name 
also represents a specific catalog in the permanent file system. All files a user makes 
permanent are associated with that user's name and this catalog. 



Validation File 

A file that contains validation information for all users (user names, passwords, resources 
allowed, and so on). 

Volume Serial Number (VSN) 

A from 1- to 6-character identifier that identifies the volume of magnetic tape to the system. 

VSN 

See Volume Serial Number. 

w 

Word 

A group of bits (or 6-bit characters) between boundaries imposed by the computer system. A 
word is 60 bits in length. The bits are numbered 59 through starting from the left. A 
word is also composed of five 12-bit bytes, numbered through 4 from the left. 

Write Mode 

A mode that allows a user to write, modify, append, read, execute, or purge the file (modify 
permission applies only to direct access files). 



Zero-Length PRU 

A PRU that contains system information but no user data. Under NOS, a zero-length PRU 
defines EOF. 

7990 

A hardware product that is a large capacity mass storage device. The 7990 is a 
cost-effective extension to the disk file storage system and an alternative to conventional 
magnetic tape storage. 

7990 Catalog 

A disk-resident direct access permanent file that contains information describing which AUs 
of each cartridge assigned to a particular subfamily are allocated to 7990 files and which 
AUs are available for allocation. 
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The SCOPE 2 Station Facility (SSF) is a NOS software subsystem that allows a NOS user 
to submit jobs and transfer files to a linked SCOPE 2 system residing in a 7000 Computer 
Systems mainframe. With SSF, a NOS user can route jobs to a linked SCOPE 2 system for 
processing. While processing the job, the SCOPE 2 system can access permanent files and 
tape files at the NOS host. 

SSF provides these services: 

Provides NOS users with local batch capabilities at a linked SCOPE 2 system. 

Optionally serves as the system operator station for SCOPE 2. 

Provides the NOS user with remote batch capabilities, through RBF, at a linked 
SCOPE 2 system. 

Allows simultaneous transfer of multiple files. 

Optionally furnishes the deadstart file for SCOPE 2. 

Provides a means of obtaining absolute SCOPE 2 dumps. 

Allows a job executing on a SCOPE 2 system to use SCOPE 2 commands (GETPF, 
SAVEPF, and PURGE) to access permanent files at a linked NOS system. 

Allows a job executing on a SCOPE 2 system to access magnetic tape files at a linked 
NOS system. 

Equipment Configuration 

To establish a NOS-SCOPE 2 link using the SSF Subsystem, the NOS and SCOPE 2 
mainframes must be attached to a loosely coupled network (LCN) by a 6683 and 7683 
Satellite Coupler, respectively. An equipment status table (EST) device type entry of CC 
describes the coupler link. The EST table appears on the E,A display. 

SSF File Transfers 

SSF file transfers between NOS and SCOPE 2 are of two types: 

• Staged file transfers. 

• Spooled file transfers. 

Staged file transfers process one file at a time and handle all tape file and permanent file 
transfers. Spooled file transfers handle multiple I/O file transfers. Normally, operator 
intervention is not required for either type of transfer. 

SSF initiates a special type of job, called a spunoff task (SPOT) job, to perform file transfers. 
Staged file SPOT jobs differ from spooled file SPOT jobs as described in this appendix. The 
primary functions of any SPOT job are performing user validation and queuing tasks 
required to send a file across the link. All SPOT jobs are executed on the NOS system. 

Installation parameters or operator commands can be used to limit the number of file 
transfer activities that can be active concurrently. Independent limits can be set on the 
following activities: 
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Purging NOS files. 

Reading tape files from NOS to SCOPE 2. 
Writing tape files from SCOPE 2 to NOS. 
Reading permanent files from NOS to SCOPE 2. 
Writing permanent files from SCOPE 2 to NOS. 
Reading input files from NOS terminals to SCOPE 2. 
Writing output files from SCOPE 2 to NOS terminals. 
The operator commands used to set limits are described in section 8, K-Display Utilities. 

Staged File Transfers 

Staged file transfers are essentially the same for both tape and permanent file transfers. In 
response to an SSF query, SCOPE 2 indicates to SSF that an executing SCOPE 2 job 
requires access to a NOS file. The SCOPE 2 request can specify either a NOS to SCOPE 2 
file transfer, also called a prestaging transfer; or a SCOPE 2 to NOS (poststaging) transfer. 
In either case, SSF normally responds by creating a SPOT job to perform the file transfer. 
The SPOT job name is of the form xyyy, where x is the last character of the PID of the 
SCOPE 2 mainframe, and yyy is the JCB ordinal of the SCOPE 2 job. SSF places the newly 
created SPOT job into the NOS input queue, and the job executes on NOS in the same 
manner as any other job. 

During execution, the job checks that the user has the appropriate file access permission. If 
so, the SPOT job initiates the file transfer. 

For staged file transfers, each SPOT job terminates upon completion, and the job's dayfile 
(containing all processing and error messages) is sent to SCOPE 2 to be included in the 
dayfile of the job that requested the file transfer. SSF initiates a new SPOT job for each 
staged file transfer request it receives. 

SSF periodically queries SCOPE 2 about file staging activities that should be dropped. For 
example, the SCOPE 2 system operator may have dropped a job for which staging was 
active. If any file staging activities are to be dropped, SSF requests information to identify 
the staging activity and then drops the associated SPOT job. No operator intervention is 
required. 
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Spooled File Transfers 

Spooled file transfers use a single SPOT job to perform all input/output file transfers 
between SSF and SCOPE 2. As soon as communications are established between SSF and 
SCOPE 2, SSF creates a SPOT job to handle input/output file transfers. The job is called 
xSTA, where x is the PID of the SCOPE 2 mainframe. This SPOT job can be swapped out 
during periods of low activity, but the job is not terminated until the SSF-SCOPE 2 link is 
dropped. 

An input file transfer begins when the spooling SPOT job selects a file from the NOS input 
queue that is destined for the SCOPE 2 system. The SPOT job queries SCOPE 2 for a 
system file table (SFT) entry for the input file to be transferred. When an entry is assigned, 
the spoofing SPOT job transfers the input file to SCOPE 2. Upon completion of the transfer, 
the SPOT job requests that the input file be removed from the NOS input queue. 

For each output file transferred from SCOPE 2, the spooling SPOT job transfers the output 
file from the SCOPE 2 output queue to a local NOS file. When the transfer is complete, the 
SPOT job routes the local file to the NOS output queue (with the appropriate disposition 
code, forms code, or terminal ID). The spooling SPOT job then requests the removal of the 
output file from the SCOPE 2 output queue. 

Error Logout 

A loss of communications between SSF and SCOPE 2 results in an error logout condition. 
Error logout occurs as a result of a STOP command entered by the system operator, or a 
software or hardware error. When SSF detects an interruption in communications, it logs 
out of the SCOPE 2 system after: 

• All partially transmitted files are rewound on the sending end of the link and are 
deleted at the receiving end. 

• All SPOT jobs are dropped. 

No files are lost as a result of the communications break. After logging out of the SCOPE 2 
system, SSF periodically queries SCOPE 2 to determine if the link has been restored. 
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Status/Control Register Simulator D 

Error logging on a CYBER 170 Computer System enables you to detect and log errors 
identified in the status/control (S/C) register. The status/control register simulator 
(SCRSIM) allows you to set S/C register bits in order to aid in the testing of error logging 
and error recovery procedures. 

SCRSIM does not run on CYBER 180-class machines. Models 865 and 875 use maintenance 
registers instead of S/C registers. Throughout this appendix all references to S/C registers 
also apply to the model 865 and 875 maintenance registers. 

SCRSIM runs on CYBER 170 Computer Systems using the S/C register on channel 16 and, 
if more than 10 PPs are available on the system, the S/C register on channel 36. On 
CYBER 70 Computer Systems, SCRSIM uses the interlock register on channel 15. 

With the aid of a K display, you can specify commands to set and clear bits, set bytes, and 
set lines and areas in holding registers. This allows both S/C registers to be set up 
completely. The contents of the holding register can then be transferred to the S/C registers 
(64 or 128 bits are transferred to the interlock register of a CYBER 70 Computer System). 

The bits set through this simulator are logged in the error log if an error bit is set, thus 
aiding in testing and software checkout. (Refer to the appropriate hardware reference 
manual for a complete description of the significance of each S/C register bit.) The simulator 
job dayfile lists all simulator commands entered. This error logging does not occur in a 
CYBER 70 Computer System, however, unless an ENABLE,SCRSIM IPRDECK entry has 
been made. 



NOTE 



Be careful when using the simulator. Improper use may result in serious system 
malfunctions. 



Refer to the NOS Version 2 Operations Handbook for descriptions of messages produced by 
SCRSIM. 
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Using the Simulator 

Using the Simulator 

Error logging is always enabled on a CYBER 170 Computer System except models 815, 825, 
835, 845, and 855. Error logging is enabled on a CYBER 70 Computer System only if the 
ENABLE,SCRSIM IPRDECK entry is present. 

Console Operation 

The simulator is called from the console by entering: 

X.SCRSIM. 

The simulator K display (refer to figure D-l) appears on the left screen after entering: 

K, jsn. 

Entry Description 

jsn The job sequence name of SCRSIM noted on the B,0 display. 

This K display shows the contents of the temporary holding registers, as well as a central 
memory buffer. The buffer contains: 

• A history of all error status bits since the last level deadstart. If an error status bit 
has been set in the S/C register, it remains set in the buffer, even though it may have 
been cleared in the actual S/C register. This history may be useful in diagnosing system 
malfunctions. 

• All other bits in the buffer reflect actual values in the S/C register at the time the last 
error bit was set. Each time an error bit is set, the entire buffer is updated. 

Unless the simulator is running on a CYBER 170 Computer System with more than 10 PPs, 
the message 

CHANNEL 36 NOT AVAILABLE 

also appears. This indicates that no channel 36 S/C register is present on the machine, and 
thus, no simulation need be done for it. 

By entering 

KK. 

the simulator commands K display (refer to figure D-2) appears on the right screen. This 
display gives a brief description of the commands available. 

Commands can be entered on the K display by entering: 

K. command. 

Entry Description 



command One of the commands shown in figure D-2. 
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TEMPORARY HOLDING REGISTER CONTENTS 




CHANNEL 16 REGISTER - LINES 0-3 




BITS 59- 






BYTE 00 


000000000000 


000000000000 


oooooooooooo oooooooooooo 


oooooooooooo 


0000 


0000 


0000 0000 


0000 


BITS 119- 60 






BYTE 05 


000000000000 


000000000000 


oooooooooooo oooooooooooo 


oooooooooooo 


0000 


0000 


0000 0000 


0000 


BITS 179-120 






BYTE 10 


000000000000 


000000000000 


oooooooooooo oooooooooooo 


oooooooooooo 


0000 


0000 


0000 0000 


0000 


BITS 203-180 






BYTE 15 






oooooooooooo 


oooooooooooo 






0000 


0000 




CHANNEL 36 NOT AVAILABLE 






ACTUAL S/C REGISTER ERROR BUFFER 




CHANNEL 16 REGISTER - WORDS 113-116 




000000000000 


000000000000 


oooooooooooo oooooooooooo 


oooooooooooo 


000000000000 


oooooooooooo 


oooooooooooo oooooooooooo 


oooooooooooo 


000000000000 


000000000000 


oooooooooooo oooooooooooo 


oooooooooooo 






oooooooooooo 


oooooooooooo 



Figure D-l. Simulator K Display (Left Screen) 
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COMMAND 




SIMULATOR COMMANDS 

DESCRIPTION 






AREA,A,M,Y. 




SET M BITS FROM A TO OCTAL 


VALUE 


Y 


BYTE,XX,YYYY. 




SET BYTE XX TO OCTAL VALUE 


YYYY 




CLEAR, A, B, . . . ,Z. 




CLEAR BITS A,B, . . . ,Z 






CYCLE, X,T,R. 




SET BIT X EVERY 16*T MS. R 


TIMES 




END. 




END CYCLE COMMAND BEFORE R 


REACHED 


LINE,X,Y. 




SET LINE X TO OCTAL VALUE Y 




READ. 




READ S/C REGISTER INTO HOLDING REGISTER 


SET,A,B, Z. 




SET BITS A,B, . .. ,Z 






+ 




CHANGE REGISTER BEING USED 


AND K 


DISPLAY 


GO. 




ENTER HOLDING REGISTERS IN 


S/C REGISTERS 


STOP. 




END THE SIMULATOR 






ALL BIT, BYTE, AND LINE NUMBERS ASSUMED DECIMAL. 

TIME VALUES ASSUMED DECIMAL 

Y AND YYYY VALUES MUST BE OCTAL. 







Figure D-2. Simulator Commands E Display (Right Screen) 



Batch Input 

The simulator may also be called from batch input by using the SCRSIM command. The 
input file must have a record containing the commands to be processed, one command per 
card. The system must be in debug mode and the user must be validated for system origin 
privileges. 
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Simulator Commands 

The simulator commands are described next. You must enter the entire command keyword 
and only one command may be entered at a time. Each command, except +, must end with 
a terminator. In all cases, a null argument is assumed to be zero. 

Holding Register Commands 

The following commands, except GO., affect only the holding register currently displayed on 
the left screen. These commands are used to set up the entire 204 bits in the holding 
registers. GO. transfers the holding register contents to the actual S/C register. (On a 
CYBER 70 Computer System, the channel 16 S/C register is simulated by the interlock 
register. GO. transfers the first 64 of 128 bits of the holding register to the interlock 
register.) The current contents of the holding register is displayed in binary and octal on 
the left screen (refer to figure D-l). The contents of the actual S/C register are also 
displayed in binary on the left screen. 



Command 



Description 



AREA,a,m,y. Set m bits in the holding register, from bit a to bit a+m-1, to the octal 

value y. 



Parameter Description 

a Starting bit number; from to 203. a is assumed to be 

decimal, but a postradix of D or B may also be included. 

m Number of bits to be set. m is assumed to be decimal, 

but a postradix of D or B may also be included. 

y Value to which the bits are to be set. y may be up to m 

bits of octal value. 



BYTE,xx,yyyy. Set byte xx in the holding register to the octal value yyyy. 
Parameter Description 



xx 



yyyy 



Byte number; from to 16. xx is assumed to be 
decimal, but a postradix of D or B may be included. 

Value to which byte xx is to be set. yyyy may be up to 
12 bits of octal value. 



CLEAK,a 1 ,a 2 ,...,a n . Clear bits a 1 ,a 2 ,-»a n "* the holding register. If more than 30 bit 

numbers are entered, only the first 30 are processed. All others are 
ignored. 

Parameter Description 



*i 



Bit number to be cleared; from to 203. A decimal 
value is assumed, but a postradix of D or B may be 
included. 
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Command Description 



LINE,x,y. Set line x of the holding register to the octal value y. 

Parameter Description 

x Line number of the holding register shown on the left 

display screen (refer to figure D-l); from to 3. Line 
is positioned at the top and line 3 is positioned at the 
bottom. 

y Value to which line x is to be set. y may be up to 60 

bits of octal value. 

READ. Transfer the contents of the actual S/C register to the 

holding register. 

SET,a 1 ,a 2 ,...,a n . Set bits a^a^,...,^ in the holding register. If more than 30 bit numbers 
are entered, only the first 30 are processed. All others are ignored. 

Parameter Description 

aj Bit number to be set; from to 203. A decimal value is 

assumed, but a postradix of D or B may be included. 

GO. Transfer the contents of the holding register to the actual S/C register 

or to the interlock register of a CYBER 70 Computer System. No bits 
in the holding register are changed by this command. 



D-6 NOS Version 2 Analysis Handbook 60459300 U 



Simulator Commands 



Cycle Commands 



Command 



Description 



CYCLE,x,t,r. Set bit x every t periods of time, a total of r times. This command 

assumes control of the simulator for the total time period specified. 
During this time, no command is accepted except END. Bit x is set in 
the holding register by this command. 

Parameter Description 



x 
t 



Bit number to be set; from to 203. 

Number of periods of time for each cycle; one period is 

16 milliseconds. t=32 is approximately 0.5 second. 

Number of times to set bit x. r may not exceed 4095. 



END. 



End CYCLE command processing before r is reached. Control of the 
simulator is returned to the operator. 



+ And Stop Commands 



Command 



Description 



STOP. 



Toggle the K display between the channel 16 and channel 36 register 
displays and also change the register currently being worked on, if the 
simulator is being operated on a CYBER 170 Computer System with 
two S/C registers. If two S/C registers are not present on the machine, 
no action is taken. The channel 16 register is assumed when the 
simulator begins. The only holding register that is affected by the 
holding register and cycle commands is the one currently displayed. 

End simulator processing. 
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580 Programmable Format Control E 

You control the spacing and format on 580 line printers by using carriage control format 
tapes or programmable format control. The carriage control format tape is punched to 
indicate particular format channels for each frame. A printer with programmable format 
control does not use carriage control format tapes; instead, it contains a microprocessor plus 
memory. Programmable format control arrays are loaded into this memory, performing the 
same function as the format tape. This appendix describes how to create and load 
programmable format control arrays. A description of format tapes is included in the NOS 
Version 2 Reference Set, Volume 3. 

Certain 580 printers are not equipped with a carriage control tape; instead, a microprocessor 
plus memory called programmable format control is used. Instead of a tape controlling the 
page format, software is used. This software is called a programmable format control array. 
A programmable format control array consists of numbers from to 12 and 17 8 . Each 
nonzero character represents a channel. A (zero) specifies that no channel is selected. An 
array is similar to a format tape since each number in a programmable format control array 
corresponds to a line on the print form. As each line of a page is printed, the next number 
in the programmable format control array buffer is addressed. A carriage control character 
in column 1 of the output line, indicating a skip to a particular channel, causes the memory 
in the programmable format control array buffer to be sequentially addressed until the 
particular number is found. The paper is spaced a similar number of spaces. 

A programmable format control array differs from a format tape because only one channel 
can be specified per fine. A number of channels can be specified per line using a format 
tape. Also, programmable format control arrays are accessed in pairs, one for 6 lines per 
inch dpi) printing and one for 8-lpi printing. The 8-lpi array is usually larger, allowing 
more lines to be printed on the same size page. 
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Building Programmable Format Control Arrays 

Observe the following rules when building a programmable format control array. 

• Enter only valid numbers (from to 12 and 17 8 ) in the programmable format control 
array. 

• A 1 must be the first number in the programmable format control array, indicating a 
top-of-form position. 

• A 12 should always indicate the last line of the form (bottom of page). 

• A 17 8 should appear as the last number in the array, denoting the end of valid numbers 
for a given array. This number does not correspond to any particular line on the form. 

• Maximum length programmable format control arrays (132 for 6 lpi and 176 or 136 for 
8 lpi) must include a 9 only at location 132 for 6 lpi and location 176 or 136 for 8 lpi. 
Improper paper alignment may occur if a 9 is placed elsewhere. 

To properly load the appropriate programmable format control buffer for a particular form, 
it is necessary to assemble data that will contain, when transmitted and stored in the 
programmable format control array buffer, as many numbers as lines on the form. As 
stored within the programmable format control array buffer, each number is a 4-bit code 
used to represent channels (1 through 12) or a null code (no channel selected). 



NOTE 



Channels 13 and 14 are valid channels but they are not selectable. No programmable 
format control error occurs when loading these numbers into the programmable format 
control buffer. 



The maximum capacity of the 6-lpi programmable format control buffer is 132 numbers 
(22-inch form maximum) plus the last line number whereas the 8-lpi programmable format 
control buffer has a capacity of 176 or 136 numbers (22-inch or 17-inch form maximum) plus 
the last line number. Fewer than the maximum amount of numbers may be loaded into the 
programmable format control buffer, but an excessive amount of numbers will cause a 
programmable format control overflow error. 
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Adding Programmable Format Control Arrays 

Programmable format control arrays must occur in pairs (one 6-lpi array and one 8-lpi 
array); therefore, when a particular array is specified with the SC option of the ROUTE 
command, it is possible to switch from 6- to 8-lpi spacing except when using 8.5-inch forms, 
which are always printed at 8-lpi spacing. Four pairs of arrays are provided with the 
operating system, two pairs of arrays for 11-inch forms and two pairs of arrays for 8.5-inch 
forms (refer to table E-l). The numbers are omitted for 6-lpi 8.5-inch forms because this 
combination is not selectable. The form or paper size is defined in the EQPDECK unit 
record equipment EST entry. 

To add additional programmable format control arrays, BIO must be modified to contain 
these additional arrays as overlays in QAP. The overlay names and corresponding ROUTE 
command SC parameter options must be added to PFCO, and the programmable format 
control overlay table in QAP. The first entry in this table specifies the default programmable 
control format array. This array is used when the SC parameter is not specified. If an 
added array is to be the default array, the PFCO entry for it should be placed at the 
beginning of the table. The value that must be specified with the SC parameter (any 6-bit 
binary value) is included in this entry unless it is to be the default array. In this case, the 
value must be zero. The arrays that are also added to QAP must follow the same format, 
structure, and labeling conventions as the arrays already provided in QAP. To generate the 
numbers to be loaded into the programmable format control buffer, the DPFC (define 
programmable format control code) macro is used with the following format. Only the lower 
4 bits of each 6 bits are used as programmable format control numbers. 



Location 


Operation 


Variable 




DPFC 


a,b,c,d 



Variable D escription 

a, b, c, d Programmable format control numbers for 6 or 8 lpi. These numbers can be 
any value from to 12 and 17 g . 



NOTE 



In each macro call, all four parameters must be specified (0 denotes no channel is selected). 
If all four are not required to complete an array (the number of lines on the form is not a 
multiple of 4), zeros should be used for the remaining parameters. 
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Table E-l. Released Programmable Format Control Arrays 



Location 11 in. 1 8.5 in. 1 11 in. 2 8.5 in. 2 11 in. 3 8.5 in. 3 11 in. 4 8.5 in. 4 



1 


1 


2 


6 


3 





4 


2 


5 





6 





7 


3 


8 





9 





10 


4 


11 





12 





13 


5 


14 





15 





16 


2 


17 





18 





19 


3 


20 





21 





22 


4 


23 





24 





25 


5 


26 





27 





28 


2 


29 





30 





31 


3 


32 





33 





34 


4 


35 






1 

6 



2 





3 





4 





5 





7 





8 





10 





11 





2 





3 





4 





1. 6 lpi default (default is SC=1). 

2. 6 lpi alternate (alternate is SC=2). 

3. 8 lpi default. 

4. 8 lpi alternate. 



1 


1 


1 


1 


6 


6 


6 


6 

















2 





2 


2 





2 




















3 





3 














3 





3 








4 





4 


























4 


5 


4 


5 





























2 





7 


5 





5 




















3 





8 














2 





7 








4 





10 


























3 


5 


8 


11 





























2 





2 


4 





10 




















3 





3 














5 





11 








4 





4 















(Continued on next page) 
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Table E-l. Released Programmable Format Control Arrays 

11 in. 1 8.5 in. 1 11 in. 2 8.5 in. 2 11 in. 3 8.5 in. 3 11 in. 4 8.5 in. 4 



Location 


11 in 


(Continued from pre 


36 





37 


5 


38 





39 





40 


2 


41 





42 





43 


3 


44 





45 





46 


4 


47 





48 





49 


5 


50 





51 





52 


2 


53 





54 





55 


3 


56 





57 





58 


4 


59 





60 





61 


5 


62 





63 





64 


12 


65 





66 





67 


1 


68 





69 





70 


2 


71 








5 





7 





8 





10 





11 





2 





3 





4 





5 





12 





1 





2 





1. 6 lpi default (default is SC=1). 

2. 6 lpi alternate (alternate is SC=2). 

3. 8 lpi default. 

4. 8 lpi alternate. 















2 


5 


2 


5 





























2 





7 


3 





3 




















3 





8 














4 





4 








4 





10 


























5 


5 


5 


11 





























2 





2 


2 





7 




















3 





3 














3 





8 








4 





4 


























4 


5 


10 


5 





























2 





7 


5 





11 








12 





12 


























2 


1 


2 


1 
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Table E-l. Released Programmable Format Control Arrays 



Location 11 in. 1 8.5 in. 1 11 in. 2 8.5 in. 2 11 in. 3 8.5 in. 3 11 in. 4 8.5 in. 4 



(Continued from previous page) 



72 





73 


3 


74 





75 





76 


4 


77 





78 





79 


5 


80 





81 





82 


2 


83 





84 





85 


3 


86 





87 





88 


4 


89 





90 





91 


5 


92 





93 





94 


2 


95 





96 





97 


3 


98 





99 





100 


4 


101 





102 





103 


5 


104 





105 





106 


2 


107 








3 





4 





5 





7 





8 





10 





11 



2 


3 


4 


5 


7 







2 


3 














3 








4 








4 














5 


5 




















12 














3 








1 








4 














2 


5 

















2 


3 














3 








4 








4 














5 


5 


















2 


3 














3 








4 








4 














5 


5 

















7 


12 














8 








1 








10 














2 


11 

















2 


3 














3 








4 








4 














5 


5 















1. 6 lpi default (default is SC=1). 

2. 6 lpi alternate (alternate is SC=2). 

3. 8 lpi default. 

4. 8 lpi alternate. 



(Continued on next page) 
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Table E-l. Released Programmable Format Control Arrays 

Location 11 in. 1 8.5 in. 1 11 in. 2 8.5 in. 2 11 in. 3 8.5 in. 3 11 in. 4 8.5 in. 4 

(Continued from previous page) 



108 








109 


3 


8 


110 








111 








112 


4 


10 


113 








114 








115 


5 


11 


116 








117 








118 


2 


2 


119 








120 








121 


3 


3 


122 








123 








124 


4 


4 


125 








126 








127 


5 


5 


128 








129 








130 


12 


12 


131 








132 


9 


9 


133 


17 8 17 8 


134 






135 






136 






137 






138 






139 






140 






141 






142 






143 










2 





7 


2 





7 




















3 





8 














3 





8 








4 





10 


























4 


5 


10 


11 





























2 





2 


5 





11 




















3 





3 














2 





2 








4 





4 


























3 


5 


3 


5 





























2 





7 


4 





4 








12 





12 

















9 





9 


5 


17 8 


5 


17; 























2 






7 

























1. 6 lpi default (default is SC=1. 

2. 6 lpi alternate (alternate is SC=2). 

3. 8 lpi default. 

4. 8 lpi alternate. 
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Table E-l. Released Programmable Format Control Arrays 



Location 


11 


in. 1 


8.5 in. 1 11 in. 2 


8.5 in. 2 11 in. 3 8.5 


in. 3 11 in. 4 8.5 in. 4 


(Continued fr< 


om 


previous page) 






144 














145 








3 


8 


146 














147 














148 














149 








4 


10 


150 














151 














152 














153 








5 


11 


154 














155 














156 














157 








2 


2 


158 














159 














160 














161 








3 


3 


162 














163 














164 














165 








4 


4 


166 














167 














168 














169 








5 


5 


170 














171 














172 














173 








12 


12 


174 














175 














176 








9 


9 


177 








17c 


17. 



1. 6 lpi default (default is SC=1). 

2. 6 lpi alternate (alternate is SC=2). 

3. 8 lpi default. 

4. 8 lpi alternate. 
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533/536, 537, and 585 Printer Electronic 
Vertical Format Unit (EVFU) F 

Upon startup, the printer support utility (PSU) looks for an EVFU load file which is a public 
file named EVFULFN under the network user name NETOPS. The EVFU load file contains 
definitions which describe all 533, 536, 537, and 585 printers to be serviced by PSU. In 
addition, for 533/536 printers it contains directives that describe the actions to be taken 
while printing files that have format control characters in column 1 and the page length and 
print density specified. EVFU information for 537 and 585 printers is supplied by CDCNET, 
and is documented in the CDCNET Configuration and Site Administration Guide. 

PSU supports up to 12 printers with any mix of 533/536, 537, and 585 printers. The printer 
directives in the released EVFU file specify PEINT01 through PRINT04 as 533/536 printers; 
PRINT05 and PRINT06 as 537 interactive printers and PRINT07 and PRINT08 as 537 
batch printers; and PRINT09 through PRINT12 as 585 printers. If these printer names are 
not correct for the printers being used, the EVFU file will have to be changed accordingly. If 
533/536 printers are used, the 533/536 printer definitions must follow all other printer 
definitions, which are then followed by the 533/536 EVFU load data. If a mismatch occurs 
between the EVFU load file printer definition and the connection received from the network, 
the connection is placed in a HOLD state and a K-display message provides the pertinent 
information. If the K-display is not assigned when this occurs, a flashing B-display message 
requests that the K-display be assigned to PSU. 



EVFU Directives for 533/536 Printers 

EVFU directives follow the printer definitions in the EVFU load file. The presence of a 
character in column 1 initiates a new EVFU directive. A line with a blank in column 1 is a 
continuation of the line that started the current EVFU directive. Blank lines are not 
permitted in the EVFU load file. An EVFU directive terminates with a semicolon or 
end-of-line. You can add comments to an EVFU directive line following the semicolon. 

An EVFU load file contains two types of EVFU directives: 

• Format control directives. 

• EVFU load directives. 



Format Control Directives 

The character in column 1 of each line of a print file is a format control character. PSU 
translates this character into a string of one or more data characters that are output 
instead of the format control character. 

A format control directive consists of a single format control character followed by the 
associated data for PSU to output in place of the format control character specified in the 
directive. At least one space must separate the format control character from the data 
characters. There are two formats for the data characters, and you can intermix the two 
formats. The first data format is pairs of hexadecimal digits representing ASCII characters. 
These pairs of digits may be separated from each other by spaces for readability. The 
second data format is ASCII strings delimited by quotation marks, for example, "data". 
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You can specify a maximum of six data items in a format control directive. They can be 
hexadecimal digit pairs or ASCII strings or both, but not more than a total of six items 
representing ASCII characters. Character data should not extend over line boundaries. 

PSU supports the following format control characters: 

Character Description _____ 

1 Eject page before printing. 

2 Skip to last line of form before printing. 

+ Skip zero lines before printing (overprint), 

space Single space. 

Skip one line before printing (double space). 
- Skip two lines before printing (triple space). 

8 Skip to top of page (channel 1) before printing. 
7 Skip two lines (channel 2) before printing. 

6 Skip three lines (channel 3) before printing. 

5 Skip four lines (channel 4) before printing. 

4 Skip five lines (channel 5) before printing. 

3 Skip one page (channel 6) before printing. 

9 Skip seven lines (channel 7) before printing. 
X Skip eight lines (channel 8) before printing. 
Y Skip three lines (channel 9) before printing. 
Z Skip ten lines (channel 10) before printing. 
W Eject page (channel 11) before printing. 

U Eject page (channel 12) before printing. 

A Eject page after printing. 

B Skip to last line of form after printing. 

/ Skip zero lines after printing (overprint). 

H Skip to top of page (channel 1) after printing. 

G Skip two lines (channel 2) after printing. 

F Skip three lines (channel 3) after printing. 

E Skip four lines (channel 4) after printing. 

D Skip five lines (channel 5) after printing. 

C Skip one page (channel 6) after printing. 

1 Skip seven lines (channel 7) after printing. 
J Skip eight lines (channel 8) after printing. 
K Skip three lines (channel 9) after printing. 
L Skip ten lines (channel 10) after printing. 
M Eject page (channel 11) after printing. 

N Eject page (channel 12) after printing. 

Q Clear auto page eject. 

R Set auto page eject. 

5 Set 6-lpi print density. 
T Set 8-lpi print density. 

If column 1 of a format control directive contains a blank or any character that has not been 
defined, PSU performs a line termination and line feed sequence. Thus, the concept of an 
invalid format control character does not exist. Lines with something other than a defined 
character in column 1 will have that character replaced by a blank. Following the fine feed, 
processing of the rest of the line will continue as normal. 
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Note that Q, R, S, and T may appear either as format control characters or as EVFU load 
characters. However, if both are specified, the format control character takes precedence 
and the EVFU load character will not be used. 

The level number mentioned earlier corresponds to various combinations of page size and 
print density or spacing codes that can be specified. The following EVFU level numbers are 
defined for the default EVFU load file: 

Level Number Description 



1 Defines a 12-inch form length with a 6-lpi print density. 

2 Defines a 12-inch form length with an 8-lpi print density. 

3 Defines an 11-inch form length with a 6-lpi print density. 

4 Defines an 11-inch form length with an 8-lpi print density. 

5 Defines an 8.5-inch form length with a 6-lpi print density. 

6 Defines an 8.5-inch form length with an 8-lpi print density. 

If you specify a spacing code or request a forms length/density for which no load data exists, 
PSU will issue a message to the printer, then rewind the output file, and print it using the 
default EVFU level of 3. 

EVFU Load File Example 

Figure F-l provides an example of an EVFU Load File. It shows the required order of 
directives for a 533/536 printer EVFU load file; printer definitions are first, format control 
directives are next, and EVFU load directives are last. 

In this example, IB 5C is the trailer for all EVFU data except for the print density 
selection. For format control directives (skip to channel), the leader is IB 50 22. For EVFU 
load directives, the leader is IB 50 23. However, the printer paper must be positioned at the 
top of form any time the EVFU is changed because that is how the printer determines the 
top of form (when the EVFU is changed). Hence, all EVFU load data starts with 0C (form 
feed). The IB 63 in the V load directive is a printer reset. A T specifies the total number of 
lines on the form (T66). An L specifies where to set a stop in a particular line; for example 
L41;4;5 sets stops at positions 4 and 5 in line 41. Similarly, a C clears a stop. Items 
following the leader IB 50 23 and preceding the trailer IB 5C are separated by semicolons. 
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PRINT09 , PC=BATWFU , DOWN . 
PRINT10,PC=BATWFU,DOWN. 
PRINT11, PC=BATWFO,DOWN. 
PRINT12 , PC=BATWFU , DOWN . 
PRINT05,PC=INTNVFU,DOWN. 
PRINT06, PC=INTNVFU,DOWN. 
PRINT07 , PC=INTNVFU, DOWN. 
PRINT08 , PC=INTNVFU, DOWN . 
PRINT01 , PC=C53 6INT , DOWN . 
PRINT02 , PC=C53 6 INT, DOWN . 
PRINT03 , PC=C53 6INT , DOWN . 
PRINT04 , PC=C53 6INT , DOWN . 
8 IB 50 22 "1" IB 5C 



} Printer Definitions 
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22 
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IB 
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C65;4;C66;5" IB 5 



IB 5B 31 32 30 20 47 
T4 OC IB 50 23 "T88; C64; 2 ; 7;L65,-4;L86; 2 ; 7" IB 5C 

IB 5B 39 30 20 47 
V3 OC IB 63 IB 50 23 "T66; " 

"L1;1;3,-4;5;6;7;L3,-7;L4;3;L5;4;7,-" 
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■L71;5 
"L76;3 
n L81;4 
"L86;2 
IB 5C 



7;L13;3;4,-7;L15;7;" 
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5 ; 7 ; L22 ,- 3 ; L23 ; 7 ; L25 ,- 3 ; 4 ,- 7 ; 

L27;7;L28;3;L29;4;7;" 
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Figure F-l. EVFU Load File 
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EVFU Load Image 

Table F-l shows the released EVFU load image for 533/536 printers. The channel numbers 
in the format control character descriptions correspond to the channel numbers in table F-l. 
For example, format control character Y causes the printer to skip three lines before 
printing. It does this by using channel 9 in the EVFU load image. 

Table F-l. Released EVFU Load Image: Print Lines and Channel Numbers 



Print 

Line 123456789 10 11 12 



I XXXXXXXXXX 

2 

3 X 

4 X X 

5 XX 

6 X 

7 XX X 

8 X 

9 XX X 

10 X X 

II X X X 
12 

13 XXX X 

14 

15 X X 

16 XX X 

17 XX X 
18 

19 X X X 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 



X XX 




X 


X 


X 


X 


X 






XXX 




X X 


X 






X 






X 




X 


X X 


X 




XX X 




X X 


X X 




X 


X 




X 


X 






X 


X 




XXX 




X 



(Continued on next page) 
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Table F-l. Released EVFU Load Image; Print Lines and Channel Numbers 



Print 
Line 



123456789 10 11 12 



(Continued from previous page) 
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40 
41 
42 
43 
44 
45 
46 
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54 
55 
56 
57 
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59 
60 
61 
62 
63 
64 
65 
66 
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69 
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X 
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X X 
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X X 

X X 
X 

XXX 
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X 
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X 



X X 
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X 
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X X X X 
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X 
X X 

X 
X X 

X X 
X 



X 
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X 



X X 



X 



X 



X X 



X 



X X 



X X 
X 



2 
3 



1. Set for 8.5 inch form at 6 lines per inch. 

2. Set for 11 inch form at 6 lines per inch. 

3. Set for 8.5 inch form at 8 lines per inch. 

4. Set for 11 inch form at 8 lines per inch. 



2 
3 



(Continued on next page) 
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Table F-l. Released EVFU Load Image: Print Lines and Channel Numbers 
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Line 123456789 10 11 12 
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1. Set for 12 inch form at 6 lines per inch. 

2. Set for 12 inch form at 8 lines per inch. 
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FORMAT Command G-2 

Input Formats G-4 

Control Directives G-4 

Data Statements G-5 

Output Formats G-6 

Accessing Disk Devices G-ll 

Access for Read Operations G-ll 

Access for Read and Write Operations G-12 
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881/883 Pack Reformatting Utility G 

Each 881 disk pack used in the 844 disk contains factory-recorded flawing information on 
cylinder 632 8 (410), track 0, sectors 0, 1, and 2. Each 883 pack contains this information on 
cylinder 1466 8 (822), track 0, sectors 0, 1, and 2. The following information is included on 
the cylinders. 

• Cylinder 632 8 (or 1466 8 for 883 packs), track 0, sector contains the factory-recorded 
manufacturing data. This data consists of the pack serial number and the 
manufacturing date. 

• Cylinder 632 8 (or 1466 8 ), track 0, sector 1 contains the factory map. This map contains 
a list of all factory-detected flaws, both correctable and uncorrectable. 

• Cylinder 632 8 (or 1466 8 ), track 0, sector 2 contains the utility map. This map originally 
contains all factory-detected uncorrectable flaws. This map is updated by the 
reformatting utility. 

FORMAT is a CPU program that operates in conjunction with FDP, a PP program, to 
maintain and reformat 881/883 disk packs. It is used to perform the following functions. 

• Factory-recorded manufacturing data, factory-recorded flaw data, and utility flaw data 
can be retrieved from a factory-formatted disk pack. 

• Sector and track flaws can be set or cleared on a factory-formatted disk pack. 

• Address fields of a previously factory-formatted disk pack can be restored. (This 
function is used only in the event that addresses on the pack are lost.) 

In order to function, FORMAT requires that the factory-recorded data [sectors and 1 of 
cylinder 632 8 (or 1466 8 )] be correct and readable. The pack cannot be processed if this data 
is unreadable. If packs are available that do not contain this factory-recorded information, 
consult a customer engineer to have this information placed on the packs. Also, the correct 
level of controlware must be present in order for FORMAT to function. To determine the 
controlware level and for procedures to install this controlware, refer to the NOS Version 2 
Installation Handbook. Since the operating system requires that the utility map contain the 
physical flaw information in order for automatic logical flawing to be performed, it is 
important that the utility map be properly maintained. 

The operating system automatically sets logical flaws when initial i zi n g 844 equipment. This 
is done by reading the utility map of the 844 units involved, and mapping this physical flaw 
information into the corresponding logical track addresses. Logical track flaw reservations 
are then made in the track reservation table (TRT) for the 844 equipment being installed. 
For example, if the 844 equipment being initialized consists of two physical units (such as a 
DI-2 configuration), the logical flaws set in the TRT are obtained from the physical flaw 
information recorded in the utility maps of both units making up the DI-2 configuration. 
This automatic flawing occurs when an equipment is initialized, regardless of whether the 
initialization is done during deadstart or online. Automatic flawing also occurs when an 
X.FLAW request is made from the console. 
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The operating system allows for setting and clearing flaw information. The SLF and CLF 
APRDECK entries set or clear logical track reservations in the TRT of the equipment. 
(Refer to section 3, Deadstart Decks, for information concerning these entries.) If the device 
is then checkpointed, this flaw information is preserved in the TRT portion of the device 
label. The SLF entry can be made during deadstart, during online initialization, or by using 
the FLAW utility (as described in section 8, K-Display Utilities). In any case, the flawing 
done via these entries is only logical; the flaw information remains only in the TRT and is 
discarded on subsequent deadstart initialization. This information is also lost during online 
initializations if it was not possible to recover the equipment. Using SLF does not cause any 
additional information to be recorded in the utility map; only FORMAT is capable of 
updating the utility map data. Caution should be used if attempts are made to cancel a 
logical flaw that was made during automatic flawing, since the physical disk sector is still 
marked as flawed and attempts to access that sector yield error conditions. 

The use of the FORMAT utility for maintaining and reformatting 881/883 disk packs is 
described next. 

FORMAT Command 

Processing maintenance operations on an 881/883 type disk pack is initiated by the 
FORMAT command. This program interfaces with you as required. The format of this 
command is: 

FORMAT, p-^pj, . . -,P n . 

Each pj is a keyword or a keyword equated to a value. 

Pj Description 

G=m Relative unit of a multispindle device. This value is checked for validity 

within the device. For example, if the device is a DI-2 and G=2 is 
specified, an error results. 

I=infile File on which input directives and data are written. 

I Same as I=INPUT. 

L=outfile Output file on which the information extracted from the disk pack is to 

be written. (Refer to Output Formats later in this appendix.) 

L Same as L=OUTPUT. 
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Pi 



Description 



MODE=mode Operational mode for FORMAT. 



mode 



Description 



ALTER The input file contains directives to control the set or 

clear flaw operations (refer to Input Formats later in 
this appendix). 

FETCH The factory-recorded flawing information contained on 

cylinder 632 8 (or 1466 8 ), track 0, sectors 0, 1, and 2 is 
obtained and copied to the output file (and optional 
output file, if available). 

RESTORE The addresses, flawed sectors, and tracks are restored 

according to information given in the utility flaw map. If 
the utility flaw map is not intact, the program aborts. 



MODE Same as MODE=FETCH. 

0=filename Optional output file to contain the output extracted from the disk pack. 

NOTE 

If output files other than OUTPUT or optional output files are specified, 
they should be created prior to the initiation of FORMAT. If they are 
not, they are destroyed upon completion of FORMAT processing. 



P=serialnumber Pack serial number in decimal of the pack to be processed. If 

serialnumber does not match the serial number recorded on the disk 
pack at the factory, processing does not occur. 



U=est 



V 



Same as P=0. 

EST ordinal of the 844 drive on which the disk pack is mounted. The 
unit is checked to ensure that it is available for formatting (refer to 
Accessing Disk Devices later in this appendix). 

Specifies that the utility is to verify the addresses recorded on the disk 
pack. This parameter is valid only if MODE=FETCH or 
MODE=RESTORE is specified. 



Example: 

If all default values are used, the following call is made. 

FORMAT , I =INPUT , L=OUTPUT , MODE=FETCH , P= . 

At least the U and the P parameter must be correctly specified to initiate processing. 
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Input Formats 

Input to FORMAT consists of control directives and data statements. Control directives 
specify the type of operation to be performed. Data statements specify locations on the pack 
where the operations are to be performed. A number of data statements may follow each 
control directive. Control directives and data statements are contained on the input file. 
This file is accessed only when MODE=ALTER has been specified on the FORMAT 
command. The input file (and therefore, control directives and data statements) has no 
significance when MODE=FETCH or MODE=RESTORE is specified. 

Control Directives 

Control directives begin in column 1. The format is: 

directive 
The following are acceptable directives. 

Directive Description 

SET Declares that the following data statements contain the addresses of flaws 

to be set and entered in the utility flaw map. 

CLEAR Declares that the following data statements contain the addresses of flaws 

to be cleared and deleted from the utility flaw map. 

FINIS Declares the end of the input. No information following this directive is 

processed. This directive is optional. 

SET and CLEAR directives may be intermixed in the input file. However, all CLEAR 
operations are performed before any SET operation. Any attempt to alter the factory map or 
to set or clear sector flaws in a previously flawed track results in an error. 
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Data Statements 

Data statements begin in column 1. The format is: 

x,cccc, tt,ss 

Parameter Description 



Type of flaw to be set or cleared. Acceptable values are: 



Description 



S Specifies that the SET or CLEAR directive applies to a sector. 
T Specifies that the SET or CLEAE. directive applies to a track. 

Octal number specifying the cylinder; from to 632 8 (or 1466 8 for 883 
packs). 
tt Octal number specifying the track; from to 22 8 . 

Octal number specifying the sector; from to 27 8 . This field is ignored for 
track flaws (x=T). 



cccc 



ss 



All input data is checked to ensure that the values are within range. Any errors in input 
result in the termination of the utility before the disk is accessed. Any attempt to alter the 
factory map, or to set or clear sector flaws in a previously flawed track results in an error. 

A maximum of 157 data statements can appear in the input stream. 
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Output Formats 

Output generated by FORMAT is placed on the output file (L=filename on the FORMAT 
command). This file, for all modes of operation (ALTER, FETCH, and RESTORE), contains: 

• A listing of the input stream, if any. 

• The pack serial number and date of factory formatting on cylinder 632 8 (or 1466 8 ), 
track 0, sector 0. 

• A listing of the factory flaw map contained on cylinder 632 8 (or 1466 8 ), track 0, sector 1. 

• A listing of the utility flaw map contained on cylinder 632 8 (or 1466 8 ), track 0, sector 2. 

• A listing of the utility flaw map following any changes resulting from SET or CLEAR 
directives. This listing appears only when MODE=ALTER is specified on the FORMAT 
command. 

• A listing of the flawed sectors and tracks as read from the disk during address 
verification. This listing appears only when MODE=FETCH or MODE=RESTORE, and 
the V parameter are specified on the FORMAT command. 

The output generated by FORMAT can be directed to an optional output file (0=filename). 
This file can then be used as input to another program, or it can be punched or printed. 

The following three examples of standard output illustrate a series of reformatting 
operations performed on the same pack. 
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Example 1: 

A RESTORE operation is performed on an 881 pack. A command similar to the following 
was entered. 

FORMAT , U=est , P=819545 , MODE=RESTORE . 

Figure G-l illustrates the resulting output. 



DISK PACK REFORMATTING UTILITY -VERSION 1.1 - 82/01/25. 

MODE = RESTORE 

DISK PACK SERIAL NUMBER 
819545 

DATE OF ORIGINAL FACTORY FORMATTING 
74/04/30 

FACTORY FLAW MAP 

(C=CORRECTABLE ERROR, S=SECTOR FLAW,T=TRACK FLAW) 
S,632, 00, 00 
S,632, 00, 01 
S,632, 00, 02 
T,302, 16, 00 
T,362, 01, 00 
T,373, 21, 00 
S,626, 15, 15 

UTILITY FLAW MAP 
(S=SECTOR FLAW,T=TRACK FLAW) 
MAP EMPTY 

PACK FORMATTING COMPLETE, VERIFICATION FOLLOWS 
S,632, 00, 00 
S,632, 00, 02 
S,632, 00, 01 

ADDRESS VERIFICATION COMPLETE 



Figure G-l- FORMAT Output, MODE=RESTORE 
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Example 2: 

The flaws noted in the factory flaw map from example 1 (refer to figure G-l) are now set in 
the utility flaw map. 

Input similar to the following was entered. 

FORMAT, U=est, P=819545,MODE=ALTER. 

— EOR-- 

SET 

S, 626, 15, 15 

T, 302, 16,0 

T, 362,01, 00 

T, 373, 21, 00 

FINIS 

--EOI-- 
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Figure G-2 illustrates the resulting output. 



DISK PACK REFORMATTING UTILITY 

MODE = ALTER 

INPUT DATA 

SET 

S.626, 15, 15 

T,302, 16, 00 

T,362, 01, 00 

T,373, 21, 00 

FINIS 



-VERSION 1.1 - 



82/01/25. 



DISK PACK SERIAL NUMBER 
819545 

DATE OF ORIGINAL FACTORY FORMATTING 
74/04/30 



FACTORY FLAW MAP 


(C=CORRECTABLE ERROR, 


S,632, 


00, 


00 


S,632, 


00, 


01 


S,632, 


00, 


02 


T,302, 


16, 


00 


T,362, 


01, 


00 


T,373, 


21, 


00 


S,626, 


15, 


15 



S=SECTOR FLAW, T=TRACK FLAW) 



UTILITY FLAW MAP 
(S=SECTOR FLAW, T=TRACK FLAW) 
MAP EMPTY 

UTILITY FLAW MAP (ALTERED) 
(S=SECTOR FLAW, T=TRACK FLAW) 
S,626, 15, 15 
T,302, 16, 00 
T,362, 01, 00 
T,373, 21, 00 



Figure G-2. FORMAT Output, MODE=ALTER 



60459300 U 



881/883 Pack Reformatting Utility G-9 



Output Formats 

Example 3: 

A FETCH with verification operation is performed to ensure proper reformatting. A 
command similar to the following was entered. 

FORMAT, U=est , P=819545 , MODE=FETCH, V . 

Figure G-3 illustrates the resulting output. 



DISK PACK REFORMATTING UTILITY 
MODE = FETCH 

DISK PACK SERIAL NUMBER 
819545 



DATE OF ORIGINAL FACTORY FORMATTING 
74/04/30 



-VERSION 1.1 



82/01/25. 



FACTORY FLAW MAP 
(C=CORRECTABLE ERROR, 
S,632, 00, 00 



S=SECTOR FLAW, T=TRACK FLAW) 



s 


632, 


00, 


01 


s 


632, 


00, 


02 


T 


302, 


16, 


00 


T 


362, 


01, 


00 


T 


373, 


21, 


00 


S 


626, 


15, 


15 



UTILITY FLAW MAP 
(S= SECTOR FLAW,T=TRACK FLAW) 
S,626, 15, 15 
T,302, 16, 00 
T,362, 01, 00 
T,373, 21, 00 



ADDRESS VERIFICATION FOLLOWS 



T 


302, 


16, 


00 


T 


362, 


01, 


00 


T 


373, 


21, 


00 


S 


626, 


15, 


15 


S 


632, 


00, 


00 


s 


632, 


00, 


02 


s 


632, 


00, 


01 



ADDRESS VERIFICATION COMPLETE 



Figure G-3. FORMAT Output, MODE=FETCH 
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Accessing Disk Devices 

Special procedures must be used to access the 844 drive used in the reformatting utility. 
Since certain FORMAT operations (ALTER and RESTORE) can change addresses on the 
pack, user access to the pack must be restricted. 

FORMAT can operate on the pack as follows. 

• A read operation (FETCH) obtains formatting information from the pack. The integrity 
of the pack is maintained. 

• Read and write operations (ALTER and RESTORE) can set and clear flaws, and 
addresses can be rewritten. Users cannot place permanent files on the pack when these 
operations occur. The integrity of the data on the pack is lost, so a full initialization of 
the pack must occur before system usage occurs. 

Access for Read Operations 

Accessing the pack for read operations requires that you specify the U parameter on the 
FORMAT command with the correct EST ordinal of the device containing the pack. In this 
case, the device must be a single-spindle device unless you also specify the G parameter. 
You must also specify the P parameter with the correct pack serial number. 

In addition, FORMAT must be called from one of the following. 

• A system origin job (from the console). 

• A system privileged job (in this case, engineering mode must have been selected on the 
system console). 
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Access for Read and Write Operations 

In addition to the information specified for read only operations, the following additional 
steps must be taken to access a device when write operations (ALTER and RESTORE) are 
to be performed. 

1. The pack to be accessed should be mounted on a removable disk device. 

2. One of the following conditions is required. 

• The device should not be a shared device. (Refer to section 13, Multimainframe 
Operations.) 

• If the device is shared, a global unload should be set. 

3. The device must be declared logically off. Use the OFF DSD command or the OFF 
parameter in the EQPDECK EQ entry. 

4. The disk status display (E,M) must show that the device is not in use. 

5. One of the following conditions is required. 

• The disk status display (E,M) must show that the device is unavailable for 
permanent file access. 

• The following conditions are required. 

- The full initialize status and the format pending status must be set. Use the 
DSD command, INITIALIZE,FP,est. 

- The direct access file user count should be equal to zero. The family status 
display (E,F) gives this information. 

If all the necessary conditions are satisfied, FORMAT is able to access the pack for 
reformatting purposes. FORMAT repeatedly checks to ensure that these conditions are 
satisfied throughout the FORMAT operation. 

At the end of the FORMAT process the disk must be initialized (INITIALIZE,AL,est) to copy 
the flaw information to the TRT and label. Otherwise, the flaw map changes will have no 
effect on NOS until the next time the disk is recovered. At that time, unreserved tracks 
marked as flaws in the flaw map will be flawed in the appropriate NOS tables. 
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NOS/VE Address Formats H 

When doing an analysis of a NOS/VE dump tape, you can specify NOS/VE addresses to the 
DSDI utility in any of several formats. These formats allow a flexible specification of the 
address range in which you are interested. 

NOTE 

To examine NOS/VE memory, the EDD dump file must contain all central memory (not just 
critical memory), and the FULL option must be specified on the DSDI command. 

Address Format Description ^ 

nn.n A real memory address (RMA). 

asid#nn..n A system virtual address (SVA). 

seg#nn..n#exch A process virtual address (PVA) based on the exchange package 

that contains the address. 

reg#exch The register and exchange package that contains the address. 

nn..n#reg#exch A PVA formed from the segment field of the specified register 

pointed to by the specified exchange package. In this format nn..n is 
the byte offset from the beginning of the segment. 

PVA#exch The address in the pseudo register PVA of the specified exchange 

package. 

exch The address as the beginning of the specified exchange package. 

The number sign (#) character is used in address formats to separate parts of the address 
parameter. Commas cannot be used because they delimit parameters within DSDI 
directives. 

The symbols used for the various parts of the address formats are described as follows: 

Symbol Description 

nn..n A number (octal, decimal, or hexadecimal as required by the 

directive) of from 1 to 8 digits. 

seg A hexadecimal number of from 1 to 3 digits specifying a segment 

number. 

asid A hexadecimal number of from 1 to 4 digits spedfying an actual 

segment identifier. 
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reg Any one of the following registers: 
reg Description 



P Specifies the processor P register. 

RAO to Specifies the corresponding address register to F 

RAF hexadecimal. 

RN1 to Specifies the top of stack address for the 

RN15 corresponding ring 1 to 15. 

UTP Specifies the address in the untranslatable pointer 

register. 

TP Specifies the address in the trap pointer register. 

exch Either a hexadecimal number of from 1 to 6 digits specifying an 

RMA of an exchange package (used to get the register values, 
segment table address, and segment table length needed to change 
the real address into a PVA), or one of the following keywords: 

exch Description 

MPS Address pointed to by the monitor process state 

register. 

JPS Address pointed to by the job process state register. 

RMA Real memory address calculated using the SETRMA 

DSDI directive. 

PXP Specifies that the current processor exchange package 

be used to obtain the P register address. 



You can modify each address by adding or subtracting a hexadecimal number of bytes from 
the specified address. If the number added or subtracted is entered with no address, the 
last address specified is used as the base address. 

The following illustrates some examples of valid address formats. 

Example Address Format 

25E101 nn..n 

MPS exch 

RA0#JPS-40 reg#exch 

1000#RN1#MPS nn..n#reg#exch 

P#PXP+40 PVA#exch 
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Management Of Storage Media Defects I 

This appendix describes the process of detecting failing devices that are suspected of having 
storage media defects and the process of dealing with known storage media defects. 

Detecting Failing Devices 

This aspect of storage media management is the process of detecting failing mass storage 
devices and making informed decisions regarding the proper course of action. The action 
may be to place a failing disk in idle mode, change its threshold values, or set its device 
state to OFF or DOWN. These actions are discussed in the following paragraphs. 

When a mass storage device or channel begins to fail, the system directs new file 
assignments away from the device and inhibits access to files on the device that are being 
used by executing jobs. 

The operator is alerted to the device failure through the A,OPERATOR display. Also the 
E,E and E,H displays provide an overview of the mass storage devices that have abnormal 
conditions present. The E,E display shows that a device error has occurred on a particular 
device and the current state of that device. The E,H display shows the current mass storage 
threshold values and the current count associated with each threshold value. Refer to the 
NOS Version 2 Operations Handbook for additional information about the E,E and E,H 
displays. 

You can use the IDLE command in conjunction with the THRESHOLD command to 
maintain some degree of flexibility in deciding when to repair the failing device. For more 
information, refer to the IDLE and THRESHOLD commands in section 5, DSD Commands. 



NOTE 



The decision to continue using a failing device should be made under the advisement of a 
customer engineer. If there is a chance of data corruption due to the nature of the failure, it 
may be best to leave the device OFF or DOWN until it can be repaired. 
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Detecting Failing Devices 

Disk Idle Mode 

When a disk is in idle mode, the system temporarily eliminates access to the device when it 
starts to fail. Nonsubsystem jobs accessing the device will be rolled out so that the rest of 
the system and jobs not accessing the device can continue running. A verification algorithm 
will be used to attempt to isolate the problem to a particular part of the hardware (media, 
drive, controller, or channel). If the cause of the problem can be isolated to a failing channel 
or drive, then the system will attempt to DOWN that particular hardware resource. 

Mass Storage Thresholds 

The initial threshold values for a mass storage device are determined by THRESHOLD 
EQPDECK entries in the deadstart file. You can use the DSD THRESHOLD command to 
change the following threshold values for any mass storage device: 

• Verification failure threshold 

• Restricted activity threshold 

• Low space threshold 

• Recovered error threshold 

• Unrecovered error threshold 

These threshold values are described under the DSD THRESHOLD command in section 5. 

When the space available on a mass storage device falls below the low space threshold, the 
following message appears on the A,OPERATOR display: 

LOW SPACE ON MASS STORAGE DEVICE. 
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Dealing With Known Media Defects 

This aspect of storage media management is the process of dealing with known media 
defects on mass storage devices. This process includes keeping an accurate record of all 
known defects and preventing the system from using defective areas. You should follow 
these general steps when you or the system encounter a media defect: 

1. Record the media defect in a logbook. 

2. Use the FLAW utility to reserve (flaw) the defective area and prevent the system from 
using that space. 

3. Modify or create an APRDECK for the device containing the defect to include a 
command to flaw the defective area. 

4. Modify the EQPDECK entry for the device to include a reference to the APRDECK 
entry. 

This appendix describes general procedures for storage media management and the 
software tools you will need to perform these procedures. Later in this appendix an example 
shows the specific steps you should perform given a defined media defect problem. 

Keeping An Accurate Record of Media Defects 

Your site should maintain a logbook that documents all of the known mass storage media 
defects. This logbook should be kept by the system console so that an operator can record 
any media defect messages displayed. The information can then be used to reserve defective 
areas and thus prevent the system from using them. 

Preventing The System From Using Flawed Disk Space 

NOS allocates space on a mass storage device in units of logical tracks. For example, when 
you write a file to disk, NOS assigns a logical track to the file and then writes the file 
information to that logical track. The logical track remains assigned to the file until you 
release the file. That is, as long as the logical track is assigned to your file, it cannot be 
assigned to another file. 

To prevent NOS from assigning a defective logical track to a file, you must reserve the 
track. This is called flawing a track. However, you cannot flaw a track while it is in use; 
that is, if the logical track with the defect is currently assigned to a file, you cannot flaw the 
track until the file is released. 

If a media defect is encountered on a logical track assigned to a type of file that will not be 
released (such as, the system file, dayfiles, permanent file catalogs, and system checkpoint 
files) you will have to perform special procedures to explicitly move these files and then flaw 
the track. For example, you may need to dump and reload permanent files, reinitialize a 
disk, or deadstart the system. For a discussion of dealing with media defects encountered 
on areas assigned to these files, refer to Releasing Special Files and Reinitializing a Device 
later in this appendix. 
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Media Management Tools 

You can use the following software tools to help with storage media management: 
Error log messages for 887, 895, and 9853 disks 
FLAW utility 
APRDECK entries 
EQPDECK entries 
FORMAT utility for 881/883 disk packs 

Error Log Messages for 887, 895, and 9853 Disks 

NOS automatically detects the presence of a media defect on an 887, 895, or 9853 disk. 
NOS automatically flaws the logical track that contains the media defect when the file 
containing the logical track is released. 

When NOS encounters a media defect on an 887, 895, or 9853 disk, it issues a SEE 
A,ERROR LOG message to the operator. The operator should then use the A,ERROR LOG 
command to view the error log screen. The following message describes the media defect 
encountered: 

dtest,TKnnnn, MEDIA DEFECT ENCOUNTERED 

where dt is the device type, est is the EST ordinal of the device, and nnnn is the number of 
the logical track containing the media defect. 

The operator should copy this message to a logbook for future use. This message indicates 
that NOS has detected a media defect; it does not indicate that the defective area has been 
automatically flawed. When the file assigned to the logical track containing the defect is 
released, NOS will then automatically flaw the track. 

However, because media defects are rare (they should occur only once per device every two 
years), NOS stores only one media defect; the last defect encountered. Thus, your operator 
should always log the media defects encountered so that the information will not be lost if 
multiple defects occur. 

When NOS automatically flaws a logical track, it again issues a SEE A.ERROR LOG 
message to the operator and displays this message on the error log screen: 

dtest.TKnnnn, MEDIA DEFECT FLAWED 

The operator should copy this message to a logbook for future use. 

FLAW Utility 

If a media defect occurs during normal system operation, use the FLAW utility to reserve 
(flaw) the defective track. (You can also use the FLAW utility to clear any flaws previously 
set.) To flaw a defective logical track, you must know the EST ordinal of the device 
containing the defect and the logical track number of the defect. For more information, refer 
to FLAW K Display in section 8, K-Display Utilities. 
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APRDECK Entries 

In addition to using the FLAW utility to flaw a defective area of mass storage, you should 
also modify the APEDECK (auxiliary mass storage parameter deck) for the device 
containing the defect. 

An APRDECK is a text record on the deadstart file that is used when the device is 
initialized. APRDECK entries identify areas of mass storage that are unusable (flawed) and 
prevent the system from accessing them. The system uses the information in the 
APRDECK entries to build the track reservation table (TRT) that resides in central memory 
resident (CMR) and also in the mass storage device label for each device. 

By making APRDECK entries, you cause the system to flaw the media defects without your 
intervention during the next deadstart initialization of the device. For more information, 
refer to APRDECK in section 3, Deadstart Decks. 

EQPDECK Entries 

An EQPDECK (equipment deck) is a text record on the deadstart file that declares all the 
devices that comprise your computer system. Each device is defined to the system with an 
EQPDECK entry. An optional parameter on the EQPDECK entry declares an APRDECK 
for the device. When you create an APRDECK entry for a device, modify the EQPDECK 
entry for the device to include the reference to the APRDECK entry. For more information, 
refer to EQPDECK in section 3, Deadstart Decks. 

FORMAT Utility for 881/883 Disk Packs 

When you use the FLAW utility or an APRDECK entry to flaw an area of an 881 or 883 
disk pack, this flawing is only logical. That is, the flaw information is kept in the TRT and 
is discarded on subsequent deadstart initializations of the device. This information is also 
lost during online initializations if it was not possible to recover the equipment. 

For 881 and 883 disk packs, which contain factory-recorded utility maps, you have the option 
of storing flaw information on the utility map on the disk. To modify or add information to 
the utility map, use the FORMAT utility. For more information, refer to appendix G. 
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Dealing With Known Media Defects 

Media Defect Example 

Suppose a job encounters a media defect on a local file. The file is located on an 895 disk 
device with EST ordinal 15 and the bad track is 5010. Use the following procedure to record 
the media defect and flaw the defective area. 

1. When the system displays the message SEE *A,OPERATOR* use the A,OPERATOR 
command to view the operator screen. This message is displayed: 

13 SEE A, ERROR LOG. 

2. To view the error log, enter this command: 

A, ERROR LOG. 

The following message is displayed on the error log screen: 

EQ015,TK5010, MEDIA DEFECT ENCOUNTERED. 

3. Record the information in the media defect logbook. 

4. Enter this command to tell the system you are taking care of the problem: 

LOG, 13. 

5. When the job using the local file releases the file, the following message is displayed on 
the error log screen: 

EQ015,TK5010,MEDIA DEFECT FLAWED. 

6. Record the information in the media defect logbook. 

7. Suppose there is no APRDECK for the device with EST ordinal 15. Add the AP=nn 
parameter to the EQPDECK entry for device 15. Here is an example of what the 
EQPDECK entry should look like: 

EQ015=type , ST=ON, CH=ch, AP=00 . 

This entry assigns the first APRDECK to device 15. 

8. Create the APRDECK for device 15: 

APRD00. 
SLF=5010. 

9. Use the LJBEDIT command to place the APRDECK entry and the updated EQPDECK 
entry on the deadstart file. (Remember that the number of the APRDECK record is 
determined by its position in relation to the APRINST record and not by the number on 
the record name; it is a good idea to name the records according to their position.) 
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Releasing Special Files 

Because a media defect cannot be flawed automatically by the system until the file assigned 
to the defective track is released, you may have to release certain file types: 

File Description 



Direct access file When a flaw is detected on a track assigned to a direct access file, 
purge the file so that the system can perform automatic track 
flawing for the bad track. 

Dayfile Job dayfiles are released at job termination; system dayfiles are 

released when they are initialized or if you perform a DFTERM and 
then purge the files created by DFTERM. 

System file The system file is released at deadstart. Thus, at deadstart a 

defective track assigned to the system file will be flawed 
automatically. 



Reinitializing A Device 

Some track chains are not released unless the device is reinitialized: 

• Indirect access file chain. 

• Disk deadstart file. 

• Catalog track chain. 

If a storage media defect is encountered in one of these files, perform the following steps: 

1. Create or update an APRDECK for the device. 

2. Modify the EQPDECK entry for the device to include the APRDECK reference. 

3. Dump the files on the device to tape. 

4. Reinitialize the device. 

5. Reload the files to the device. 
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Display Disk File (DDF) Utility 



The Display Disk File (DDF) utility provides the capability to read, display, change, and 
print the contents of physical disk sectors. It is intended to be used by analysts as an aid 
when working on system problems that involve data stored on mass storage devices. 



CAUTION 



Changing disk table contents should be done carefully and only by analysts who understand 
the effects of the changes. Unless extreme care is exercised, use of DDF can lead to system 
hangs or loss of permanent files. 



Bringing Up DDF 

The DSD display for the DDF utility is brought up on the system console by entering the 
following command: 

X.DDF. 

NOTE 



Since DDF allows access to all disk space without regard for security access levels and 
categories, use of DDF in a secured system requires that the system be in 
SECURITY-UNLOCK state (refer to Secured System Control Commands in section 5, DSD 
Commands). 
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DDF Display Left Screen 

The left screen displays the following disk and control point information: 

Disk EST ordinal and equipment type. 

Current disk track and sector address. 

Central memory address and byte number of the TRT link byte for the current track. 
The link byte is intensified if it is not consistent with the sector linkage bytes. 

TRT reservation, interlock, and preserved file status for the current track. 

Family name, pack name, control point number, and JSN of the associated job. 

Track numbers for the first track of the permit chain and the first track of the indirect 
access file data chain for the specified family/pack. 

First and second control point messages, if issued. The second control point message is 
usually a disk error and is intensified. 

Contents of DDF scratch areas, labeled A through F (refer to the DDF STORE 
command). 

The recovery track pointer and track recovery word, when pack recovery is in progress. 

Various status and errors may be displayed at the bottom of the screen. 
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DDF Display Right Screen 

The right screen displays the contents of the specified disk sector. The byte numbers 
displayed in parenthesis after the central memory address are the actual byte numbers for 
the physical disk sector. The byte numbers are used in the memory changing commands. 

You can change the right screen format with the right blank key on the CC545 console or 
the tab key on the CC634B console. 

The following right screen displays are available: 

• Five Bytes Per Line. The contents of the sector are displayed in 5 bytes per line. The 
CC545 console displays one half sector per page and uses the / to toggle between the 
first and second half of the sector. The CC598B and CC634B consoles display one 
quarter of a sector per page and uses the / to increment the addresses. 

• Ten Bytes Per Line. The contents of the sector are displayed in 10 8 bytes per fine with 
byte numbers. The CC545 console displays the entire sector on one page. The CC598B 
and CC634B consoles display one half sector per page and uses the / to toggle between 
the first and second half of the sector. 

• Text Mode. The contents of the sector are displayed in text mode. The CC545 console 
displays the entire sector on one page. The CC598B and CC634B consoles display one 
half sector per page and uses the / to toggle between the first and second half of the 
sector. 

• Interpreted mode. The data is formatted in one of three ways depending on the linkage 
bytes: 

- System Sector. The file name table (FNT) word and file status table (FST) word of 
the file are displayed along with the date and time when the sector was last 
updated. If the file type is PMFT, the copy of the permanent file catalog entry 
(PFC) contained in the system sector is also displayed. 

- PFC Entry or Data Sector. The contents of one permanent file catalog entry (20 8 
words) are displayed. Some fields such as dates are decoded. The / is used to 
advance to the next PFC entry in the sector. 

- End of Information Sector. This display shows a short format of the system sector 
display. 

• Legal Commands. This display shows a list of the DDF commands. 
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Keyboard Input 

You can use the following keys to interact with the DDF display. 
Key Action Initiated 



+ Read the next sector. If positioned at EOI or the end of the track, 

the current sector is reread. 

- Read the previous sector. If positioned at the beginning of the 

track, the current sector is reread. 

Advance to the track specified in the control bytes and set the 
sector to 0. If the control bytes do not contain a track link, the 
current sector is reread. 

Advance to the next track in the TRT chain. The sector number is 
not changed. If currently at the last track in the chain, the 
current sector is reread. 

= Read the next sector, continuing past EOI. If positioned at the 

end of an EOI track, the current sector is reread. 

CR or NEXT Initiate processing of an entered command. This key also sets 

REPEAT ENTRY if a complete command has not yet been 
entered. 

Space bar Read the current sector into the buffer. The current sector is the 

sector to which the current EST ordinal, track, and sector values 
point. 

* Toggle between DSD and DDF. 

8 Increment the track number by one and read the sector. 

9 Decrement the track number by one and read the sector. 

Right blank, ->, or Change the right screen displays on the CC545 console. This 
Tab function is done by the Tab key on the CC598B console and the -+ 

(tab) key on the CC634B console. 

/ Toggle or increment the sector displays on the right screen. 

BKSP, <-, or Back Delete the previous character typed on the CC545 console. This 

Space function is done by the Back Space key on the CC598B console 

and by the back arrow «- (backspace) key on the CC634B console. 

Left blank, <-, or Esc Delete the current line being entered on the CC545 console. This 

function is done by the Esc key on the CC598B console and the <- 
(back tab) key on the CC634B console. 
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Console Messages 

The following messages may appear at the control point. 



Message 



WAITING FOR MEMORY 



READING EQxxx TPxxxx CTxxxx 



Description 



DDF is waiting for central memory to store the 
display and command processors. 

This message shows the status of checkout 
during a pack recovery operation. 



The following messages may appear 

Message 

FORMAT ERROR. 

INCORRECT ENTRY. 
INCORRECT EQUIPMENT. 

INCORRECT PARAMETER. 
REPEAT ENTRY. 
SYSTEM BUSY. 

BYTExxxx. 
LENGTH = nnnn. 



above the command line at the bottom of the left screen. 

Description 

A format error has been detected during 
translation of the entry. 

The command is not valid. 

EST is not mass storage, nor is it a null 
equipment. 

The parameter in the entry is invalid or too long. 

The entry will not be cleared after execution. 

DDF is waiting for the system to process a 
request. 

The data specified is in byte number xxxx. 

The SKIPEI command has skipped nnnn octal 
sectors. 



Some commands read several sectors. If a disk error is encountered while processing one of 
these commands, processing stops and an error code appears on the left screen. 
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DDF Commands 

All DDF commands are displayed on the bottom of the left screen as they are entered. When 
you enter a command, it must be followed by a carriage return before any action is taken. 

DDF commands are processed interpretively. After the period (.), any alphanumeric 
characters can be entered: however, the message FORMAT ERROR or INCORRECT 
PARAMETER will appear (after the carriage return is entered) if you make an error. 

Most DDF commands do not actually cause a sector to be read and displayed. After entering 
a command that changes the EST ordinal, track, or sector, you must enter a SPACE key to 
read the sector. This allows data from one sector to be read and then written to another 
sector. 

After entering a command that changes the equipment or track, the track and sector 
numbers are checked. If either the track or sector number is invalid, it will be set to zero. 

The FIND commands scan the catalog track starting at the current position and search for 
the specified catalog entry. The EST ordinal and track number of the catalog track must 
first be set using the appropriate commands (FAMILY, PACKNAM, UI, etc.). The first 
sector of the catalog track must also be read, by entering the space bar, before the FIND 
command is used. 



Command 



Description 



AUTOREAD-nnnn. 

BLDEOI. 
BOT.nnnn. 



CTB. 1 
DEP. 

DIS. 

DROP. 

DTK 1 



Read the sector every nnnn seconds. If nnnn is not entered, 1 is 
used. AUTOREAD is terminated by clearing the command entry 
with the left blank key or back tab key. 

Creates an EOI sector in the buffer. 

Back up one track. Search the TRT starting at track number 
nnnn for a track that points to the current track. If one is found, 
the current track is set to that value. If no track is found that 
points to the current track, the message INCORRECT 
PARAMETER is displayed. If nnnn is not entered, the search 
starts at track 0. 

Clear the track interlock bit for the current track and equipment. 

Disable error processing for calls to the mass storage driver to 
read a sector. (By default, error processing is disabled.) 

Drop the DDF display and call DIS to the control point. 

Drop the DDF display and PP. 

Drop tracks to the end of the chain starting with the current 
track. 



1. The keyboard must be unlocked to use this command (refer to the UNLOCK command in section 5, DSD Commands). 
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Command 



Description 



DTKssss. 2 
EEP. 



EJT.ejt. 



EST.est. 
FAMILY.familyname. 

FIND.pfn.userindex. 
FIND.pfh.. 
FIND.pfh. 
FIND..userindex. 

FIND... 

FINDISS.userindex. 



Drop tracks starting with the current track and set the EOI 
sector in the TRT to the value ssss. 

Enable error processing for calls to the mass storage driver to 
read a sector. (By default, error processing is disabled.) 

If a disk error is encountered when reading or writing a sector 
with error processing enabled, the screens will not be refreshed 
until the driver has finished performing error processing. This 
may result in the screens being blank for many seconds. 

Enter the disk address from EJT ordinal ejt (0 < ejt < largest EJT 
ordinal). The equipment, track, and sector are set to the 
beginning of the file. The message INCORRECT PARAMETER is 
displayed if the EJT entry is not used or the file does not have 
any tracks assigned. 

Enter the EST ordinal est. The equipment must be a mass 
storage device. 

Use permanent file family familyname. The family is set 
internally in DDF. PFCW in the control point area is not changed. 
The family is initially set to the family name specified in PFCW. 

Search for permanent file pfn with user index userindex. 

Search for permanent file pfn with a zero user index (i.e., a hole). 

Search for permanent file pfn with any nonzero user index. 

Search for any permanent file with user index userindex. The file 
name is ignored. 

Search for any permanent file with a zero user index. The file 
name is ignored (i.e., search for any hole). 

Starting at the current position, search for the next system sector 
with user index userindex on the chain. If userindex is not 
specified, the user index is not checked and the next system 
sector is displayed. This command is intended to be used on the 
indirect access permanent file chain. Set the EST ordinal, track, 
and sector to point to a position within the indirect chain before 
entering this command. 



2. The keyboard must be unlocked to use this command (refer to the UNLOCK command in section 5. DSD Commands). 
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Command 



Description 



FINDO.octainum. 



FINDS.string. 



FINDSS.userindex. 



FNT.fht. 



FNTL.fiit. 



FNTLC.fht. 



GETTRT.nnnn. 



HOLD. 
LOAD.c. 



Search from the current position for the octal number specified. 
The number can be 1 to 20 digits and is right justified in as many 
bytes as necessary to hold the number. The search starts on a 
byte boundary and the byte number is displayed if the search is 
successful. If the first part of the number is found at the end of 
the buffer, the search terminates even though the entire number 
is not found. If the carriage return is entered again, the search 
continues at the location of the first match. 

Search from the current position for the specified string of 
characters. If the first part of the string matches the end of the 
buffer, the search terminates even though the entire string is not 
found. The byte number of the beginning of the string is 
displayed. If the carriage return is entered again, the search 
continues at that point. 

Starting from the current track and searching to the end of the 
TRT, find and display the next system sector with user index 
userindex. If userindex is not specified, the user index is not 
checked. 

Enter disk information from the system FNT ordinal fht 
(0 < fht < largest FNT ordinal). The EST ordinal, track, and 
sector are set to the beginning of the file. The message 
INCORRECT PARAMETER is displayed if the FNT entry is not 
used or the file does not have any tracks assigned. 

Enter the disk address from the local FNT ordinal fnt 
(0 < fht < largest FNT ordinal). The EST ordinal, track, and 
sector are set to the beginning of the file. The message 
INCORRECT PARAMETER is displayed if the FNT entry is not 
used or the file does not have any tracks assigned. 

Enter the disk address from the local FNT ordinal fht 
(0 < fht < largest FNT ordinal). The EST ordinal, track, and 
sector are set to the current position of the file. The message 
INCORRECT PARAMETER is displayed if the FNT entry is not 
used or the file does not have any tracks assigned. 

This command is intended to be used on the label track. The EST 
ordinal and track must be set for the label track before the 
command is used. GETTRT reads the sector that contains the 
checkpoint TRT information for track number nnnn and displays 
the byte number within the sector for that track. 

Release the display and wait for the operator to reassign the 
display. 

Reload the EST ordinal, track, sector, and display selection from 
scratch area c. The scratch area is specified by a single alphabetic 
character. Valid characters are A through F. (Refer to the STORE 
command.) 
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Command 



Description 



PACKNAM.packname. 

PREAD. 3 

PTKnnnn. 3 

PWRITE. 3 

QFT.qft. 



Use permanent file pack packname. The pack name is set 
internally in DDF. PKNW in the control point area is not changed. 
The pack name is initially set to the name specified in PKNW. 

Read the current sector using the read protected sector function. 
This command is used instead of the space bar when reading 
protected sectors. 

Enter the protected track number nnnn. This command works 
the same as the TK command except the track number entered is 
not checked. 

Write the current sector using the write protected sector function. 
This command should be used instead of the WRITE command 
when writing protected sectors. 

Enter the disk address from QFT ordinal qft (0 < qft < largest 
QFT ordinal). The EST ordinal, track, and sector are set to the 
beginning of the file. The message INCORRECT PARAMETER is 
displayed if the QFT entry is not used or the file does not have 
any tracks assigned. 

RANDOM.nnnn.addr. Set the track and sector for random address addr using number 

nnnn as the first track. The current track is used as the first track 
if nnnn is not specified. The message INCORRECT PARAMETER 
is displayed if the random address is not on the chain. 

Set the track and sector for random address addr using the 
current track as the first track. The message INCORRECT 
PARAMETER is displayed if the random address is not on the 
chain. 

Set the track and sector for random address addr using the track 
specified by scratch area c as the first track. The scratch area is 
specified by a single alphabetic character. Valid characters are A 
through F. (Refer to the STORE command.) The message 
INCORRECT PARAMETER is displayed if the random address is 
not on the chain. 

Enter the sector number nnnn. The message INCORRECT 
PARAMETER is displayed if the sector number is too large. 

Enter the sector number of the last sector on the track. 

Scan from the current position until the EOI control bytes are 
encountered. Sc annin g stops if, at some point, the control bytes 
are incorrect or the track is not reserved. 



RANDOM..addr. 



RANDOM-caddr. 



SCnnnn. 

SO*. 

SCAN. 



3. The keyboard must be unlocked to use this command (refer to the UNLOCK command in section 5, DSD Commands). 
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Command 



Description 



SCAN.*. 



SHOWPF. 



SKIPEI. 



SKIPF. 



SKIPR. 



STB. 4 
STORE.c.comment 



TKnnnn. 
ULuserindex. 



WRITE. 4 



Scan from the current position until the end of information 
indicated in the TRT is reached. This is intended to be used for 
the indirect access permanent file chain. Note that when PFM 
delinks a track in the middle of the chain, it does not update the 
track pointer in the preceding track; which causes SCAN to stop 
at this point and display an error. 

Display the permanent file whose catalog entry is currently 
displayed. The PFC display must be on the right screen to use 
this command. The device, track, and sector from the PFC 
currently displayed are used to display the file. If the device is not 
present, the message INCORRECT PARAMETER is displayed. 

Set the track and sector to EOI based on the current position and 
information in the TRT. The number of sectors skipped is 
displayed on the left screen. 

Read the file starting at the current position until an EOF is 
encountered. 

Read the file starting at the current position until an EOR or 
EOF is encountered. 

Set the track interlock bit for the current track. 

Store the current EST ordinal, track, sector, and display selection 
into scratch area c. The scratch area is specified by a single 
alphabetic character (valid characters are A through F). The 
comment is copied to the scratch area and displayed on the left 
screen. The comment is for convenience only and is truncated 
after 10 characters. The EST ordinal, track, sector, and display 
selection can be reloaded from the scratch area using the LOAD 
command. 

Enter the track number nnnn. The message INCORRECT 
PARAMETER is displayed if the track number is too large. 

Set the EST ordinal and track for the catalog entries for user 
index userindex (userindex < 377777). The message INCORRECT 
PARAMETER is displayed if the catalog is not found (this may be 
the result of entering the wrong family name or pack name). If 
either the family name or pack name is changed after entering 
the UI command, the UI command must be reentered. 

Write the contents of the buffer to the sector currently displayed. 



4. The keyboard must be unlocked to use this command (refer to the UNLOCK command in section 5, DSD Commands). 
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Print Sector Data Commands 

The following commands are used to print the contents of the disk sector and manipulate 
the listing file. These commands use a CPU resident helper program called DDFILE. If 
DDF is unable to load DDFILE (due to system activity or other constraints), the use of 
these commands will be disabled. 



Command 



Description 



LISTING-filename. 

OUT. 
PRINT. 

PRINT.num. 

RETURN. 
REWIND. 
SETID.id. 
SKIPL. 



Set the listing file name to filename. The default listing file name 
is OUTPUT. 

Release the listing file to the output queue. 

Print the current equipment type, track, sector, TRT information, 
and the contents of the sector. 

Print the next num (octal) sectors starting with the current sector. 
Printing stops if EOI is encountered before num sectors have been 
printed. One page of output is produced for each sector printed. 

Return the listing file. 

Rewind the listing file. 

Set the identifier for the listing file to id. 

Advance from the current position of the listing file to the end of 
the file. 



Change Sector Data Commands 

The following commands are used to change the data in the current sector. If the comma (,) 
is replaced by a plus (+), the byte number xxxx is incremented after the entry is processed. 
The actual data on the disk is not changed until you enter the WRITE command. 



Command 



Description 



wyy. 

xxxx,Dcc. 



Enter value yyyy into byte number xxxx. 

Enter display code characters cc into byte number xxxx. 



60459300 U 



Display Disk File (DDF) Utility J-ll 



DDF Examples 



DDF Examples 

The following examples illustrate DDF usage. 

Example 1: 

Read the system sector for permanent file ABC under user index 1234 on family XYZ. 

Bring up the DDF display. 



X . DDF . 
FAMILY. XYZ. 

UI.1234. 



Space bar 

FIND. ABC. 1234. 
SHOWPF . 

Space bar 



Set the EST ordinal, track, and sector of the first catalog entry on 
this catalog track. 

Read the first catalog sector. 

Search the catalog track for the PFC entry. 

Set the EST ordinal, track, and sector of the file. 

Read the system sector of the file. 



Example 2: 

Look at the PFC entries under user index 1234 on family XYZ. 



X.DDF. 
FAMILY. XYZ. 

UI.1234. 



Space bar 

FIND. .1234. 



Bring up the DDF display. 

Set the EST ordinal, track, and sector of the first catalog entry on 
this catalog track. 

Read the first catalog sector. 

Search for the first file under the user index 1234. 



Example 3: 

While using DIS, look at the contents of a local file. Be sure to remember the FNT ordinal 



fnt of the file. 

DDF. 
FNTL . flit . 

or 

FNTLC.fnt. 

Space bar 



Use +, 
DIS. 



and / 



Switch control from DIS to DDF. 

Set the EST ordinal, track, and sector to the system sector of the 
file. 

Set the EST ordinal, track, and sector to the current position of 
the file. 

Read the system sector of the file (if FNTLC was entered, read 
the sector to which the file is currently positioned). 

Look at different parts of the file. 

Switch control from DDF to DIS. 
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Example 4: 

Display a system file (e.g., the VALIDUS file). Look at the DSD H display to determine the 
FNT ordinal fht. 

x . ddf . Bring up the DDF display. 

fnt . f nt . Set the EST ordinal, track, and sector to the system sector of the 

file. 

Space bar Read the system sector of the file. 

use + , - , and / Look at different parts of the file. 

Example 5: 

Determine the length of a file and display the EOI sector. Display the system sector of the 
file (see previous examples). 

skipei . Set the track and sector to the file EOI and display the number of 

sectors skipped above the command. 

Left blank Clear the message and command. 

Space bar Read the EOI sector. 

Example 6: 

Verify that a file can be read and that the linkage bytes are correct. Display the first sector 
of the file (see previous examples). 

scan. Read every sector from the current position in the file to the EOI. 

If any errors are encountered, SCAN stops and displays a 
message. SCAN verifies that the track linkage bytes match the 
TRT. 

Example 7: 

Print the contents of sectors. Display the first sector (see previous examples). 

print . num. Print the next num sectors (num must be an octal number) to a 

listing file. The default for num is 1. The default for the listing 
file is OUTPUT unless the LISTING command has been used to 
specify another file name. 

out . Put the listing file in the output queue to be printed. 

dis . File OUTPUT contains the listing file of sectors. 



60459300 U Display Disk File (DDF) Utility J-13 



DDF Examples 



Example 8: 

Often it is necessary to look at several different places on the disk. The DDF utility has a 
facility to remember disk locations. 



X.DDF. 



UI.113. 



Space bar 

FIND. XYZ. 113 
STORE. A. XYZ PFC 

SHOWPF . 

Space bar 

STORE. B. XYZ SS 
SKIPEI . 

Left blank 
Space bar 

STORE. C. XYZ EOI 
LOAD. A. 

Space bar 

LOAD.B. 

Space bar 

LOAD.C. 

Space bar 



Bring up the DDF display. 

FAMILY. ABC. 

Set the EST ordinal, track, and sector of the first sector of the 
catalog track. 

Read the first sector of the catalog track. 

Find the PFC entry for the file XYZ on user index 113. 

Save the current EST ordinal, track and sector in scratch area A. 
Save the characters XYZ PFC as a comment. This information is 
displayed on the left screen. 

Set the EST ordinal, track, and sector for the system sector of the 
file. 

Read the system sector of the file. 

Save the current EST ordinal, track, and sector in scratch area B. 
Save the characters XYZ SS as a comment. 

Skip to the EOI sector of the file. 

Read the EOI sector of the file. 

Save the current EST ordinal, track, and sector in scratch area C. 
Save the characters XYZ EOI as a comment. 

Reset DDF to display the PFC entry. 

Read the PFC sector. 

Reset DDF to display the system sector. 

Read the system sector. 

Reset DDF to display the EOI sector. 

Read the EOI sector. 
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Example 9: 

Change data on the disk. Display the sector to be changed. Determine from the display the 
byte number of the byte to be changed. 



CAUTION 



Be very careful and be sure you know what you are doing before changing data on the disk. 
Unless extreme care is exercised, use of DDF to change data on the disk can lead to system 
hangs or loss of permanent files. 



UNLOCK. 



xxxx,yyyy. 



WRITE. 



Return control to DSD. 

Allow privileged commands to be entered. 

Return control to DDF. 

Set byte number xxxx to value yyyy. If a mistake is made, press 
the space bar to reread the sector and start over. 

Write what is displayed to the disk. 



CAUTION 



Be sure another program does not change the sector between the time DDF reads it and 
writes it; otherwise, the changes may be lost. Depending on what you are changing, it may 
be best to make changes only when the system is idle. For changes to permanent files and 
catalog entries, the STB and CTB commands can be used to prevent other accesses to the 
sector; however, an understanding of permanent file interlocking is advisable before you use 
these commands. 



Example 10: 

Display the disk flaw map. First, determine (from the appropriate hardware manual) the 
logical track and sector of the flaw map. This is not currently operational for buffered 
devices. 



X.DDF. 
EST. est. 
* 

UNLOCK. 

* 

PTK.nnnn. 

SC.nnnn. 

PREAD. 



Bring up the DDF display. 

Set the EST ordinal est. 

Return control to DSD. 

Allow privileged commands to be entered. 

Return control to DDF. 

Set the protected track number nnnn. DDF does not verify that 
the track number is valid. 

Set the sector number nnnn. 

Read the sector using a protected read function. (Do not attempt 
to read the sector using the space bar; this would cause a disk 
error because this sector is protected.) 



60459300 U 



Display Disk File (DDF) Utility J-15 



Pack Recovery 



Pack Recovery 

In the event that the label sector and TRT on a device have been overwritten and no 
suitable backup is available, a special set of DDF commands are available to allow the 
reconstruction of these tables. Note that this process requires extensive analyst 
intervention (on the order of several hours of dedicated time). 

To effectively use these commands, an analyst must have a thorough and detailed 
understanding of the NOS mass storage and permanent file table structures, both in CMR 
and on disk. Recovery achieved by these commands is not automatic; the analyst will have to 
make manual changes to the label sector and TRT during the process of the reconstruction. 

Refer to Pack Recovery Hints later in this section for an outline of the procedure to be used. 

Pack Recovery Display Changes 

When pack recovery is in progress, the recovery track pointer and the track recovery word 
are displayed on the left screen. 

Recovery Table Format 

The pack recovery process uses a recovery table in central memory to record linkage 
information. The table is initialized by the BEGINR command. The other commands use or 
modify the data in the table to effect device recovery. The table (which is stored within 
DDF's central memory field length) is formatted as follows: 

• Image of MST for the device (MSTL words long). 

• FNSS/FTSS/DTSS words from the system sector of the current chain. 

• Recovery pointer word. 

59 47 35 23 



FT 



PT 



SC 



UNUSED 



3 



Field Descr iption 

FT First track of the current chain. 

PT Previous track in the chain. 

SC Current sector for the EOI search after an error. 
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• Indirect chain pointer word (not currently used). 
59 47 35 



Field 



FT 


PT 


UNUSED 



Description 



FT 
PT 



First track of the indirect chain. 
Previous track of the indirect chain. 



Build pointer word. 



59 




tf 




35 




25 




11 





TT 


SC 


FT 


NF 


TL 



Field 



Description 



TT 
SC 
FT 

NF 
TL 



Destination track for writing the TRT. 
Sector for the current piece of the TRT. 
First track for the current piece of the TRT. 
DAF file count. 
TRT length from the MST. 



• Two reserved words. 
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Track recovery table (one word per track). 
59 47 35 



23 



11 







FLAGS 


FT 


PT 


NT 


« 1 


Field 


Description 




FLAGS 


The following flags 


are valid: 




Flag 

TY 


Bits 

59-54 


Description 




File type from system sector (for tracks beginning 
with a system sector). 




RE 


53 


Read error detected in track. 




SS 


52 


System sector in track at other than sector zero. 




FL 


51 
50 


Flawed track indicator. 
Not used. 




EI 


49-48 


EOI status for track (0, 1, or 2). 

No EOI. 

1 Normal EOI in track. 














2 EOI (written by EMS). 



FT 
PT 

NT 
LC 



First track of the chain linked to this track. 

First track encountered that is linked to this track. (PT equals the 
current track if at the start of the file.) 

Next track or EOI sector number. 

Linkage count. (Number of tracks linked to this track.) 
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Pack Recovery Commands 

The BEGINR command must be entered as the first command of a pack recovery sequence; 
until the BEGINR command is entered, none of the other pack recovery commands will be 
accepted. All of these commands require that the keyboard be unlocked. 



Command 



Description 



BEGINR. 



BLDSL. 



BLDSTRT. 



BLDSTRT.nnnn. 



Begin track recovery for the current selected equipment. The 
equipment to be recovered must be removable and unloaded. 
The MST in CMR for the selected equipment is used to 
initialize the MST for the label track built by the recovery 
commands. Be sure the equipment mnemonic in the E,M 
display matches that of the pack to be recovered. (The correct 
mnemonic can be set with the DSD INITIALIZE command.) 

The first use of this command initializes the recovery process 
by: 

• Setting the recovery track pointer to zero. 

• Reserving and clearing the central memory (CM) recovery 
table. 

• Setting up the MST skeleton in the recovery table. 

• Enabling the use of the other recovery commands. 

If the BEGINR command is used again, recovery restarts for 
the current equipment. 

Build a label sector image in the data buffer from data in the 
CM recovery table. Once the other recovery commands have 
completed, memory change commands can be used to fill in any 
missing data. The buffer can then be written to disk using the 
WRITE command. 

Build the next sector of the TRT data for the label track. The 
track and sector are set for the WRITE command. If any 
linkage errors are detected, the message ERROR IN TRACK 
STATUS is issued. After the last sector is built, the pointers 
are reset to the first sector again. You must manually generate 
the EOI sector for the label track using the BLDEOI command. 

Build sector number nnnn of the TRT data for the label track 
(nnnn > 1). 
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C omman d 



Description 



NEXTAT. 



NEXTSS. 



RECOVER.RECOVER.C. 



Locate the next available track on the current equipment and 
read the first sector of that track. The search begins at the 
displayed recovery track pointer +1. By resetting the track 
pointer to track zero and using this command, unreserved 
tracks can be found and checked for being part of the catalog 
track chain or the indirect access file chain. 

Locate the next track in the recovery table that begins with a 
system sector. The search begins at the displayed recovery 
track pointer +1. 

Scan the entire device, saving linkage information in the track 
recovery table. The first sector of each track is read until a 
system sector is found. For non-SYFT system sectors and for 
SYFT files other than DATA, read each sector (following the 
sector linkage) until either an EOI sector, a multiple linkage, 
an embedded system sector, or a read error is encountered. For 
SYFT files LABEL, DATA, and PERMIT, set the ALGL track 
pointer in the MST skeleton. 

If the scan stops for any reason, it can be restarted by entering 
either the RECOVER or RECOVER.C command (where c is any 
character). Entering RECOVER.C resumes the linkage chain 
scanning from the sector after the one in which the scan 
stopped. Entering RECOVER causes DDF to go back to the last 
track on which a system sector was found, advance the track by 
one, and resume scanning the first sector of each track looking 
for another system sector. Once the RECOVER command has 
been used to scan the entire device (which may take several 
hours) the other commands can be used to resolve any linkage 
conflicts or other loose ends that remain. 

NOTE 

DDF releases the display to DSD while executing the 
RECOVER command to improve performance (minimize lost 
revolutions). The display is automatically rerequested when the 
scan stops for any reason. 



SETRW.b.nnnn. 



SETTP.nnnn. 



Change byte b of the current track recovery word to number 
nnnn. This is the method used to resolve linkage conflicts 
before using the BLDSL and BLDSTRT commands. 

Set the recovery track pointer for the RECOVER, NEXTAT, 
NEXTSS, and SETRW commands to track number nnnn. 
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Pack Recovery Hints 

The general process for recovering a pack is as follows: 
Example Explanation 



BEGINR. 

recover. Repeat as many times as required. 

setrw. Repeat as necessary to correct linkage conflicts and oversights. 

BLDSL . 
WRITE. 

bldstrt . Repeat until TRT is complete. 

write . Repeat until TRT is complete. 

sc . nnnn . Set EOI sector address. 

BLDEOI . 
WRITE. 

There are, however, several manual operations required in addition to the process outlined 
above. 

• Several fields in the MST image in the label sector must be entered manually after the 
BLDSL command and before the WRITE command. These include: 

- Family/pack name. 

— Device number. 

— Device masks. 

- Number of catalog tracks. 

• The catalog tracks are not automatically recovered. The NEXTAT command can be 
used to search for the catalog tracks after the device has been completely scanned by 
the RECOVER command. In general, the catalog tracks are allocated on a device 
immediately prior to the first track of the indirect chain. (The first track of the indirect 
chain can be found by checking byte of ALGL in the MST, built by the BLDSL 
command.) Once the catalog tracks are found, the track linkage information for these 
tracks must be set in the track recovery words by using the SETRW command. 

The label track must be linked to the first catalog track, which is linked to the second 
original catalog track, which is linked to the third original catalog track, and so forth. 
All overflow catalog tracks are linked after the last of the original catalog tracks. 

There can be one or more overflow catalog tracks for each of the original catalog tracks. 
These overflow tracks are linked from their corresponding catalog track via the sector 
linkage in the last sector of that track. This means that the sector linkage does not 
correspond to the TRT linkage for these tracks. 
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The indirect chain is not automatically recovered. Tracks in the indirect chain can be 
located using the NEXTAT command and the RECOVERx or FINDISS commands. 
Tracks for which bit 52 is set in the recovery word (which indicates that a system sector 
was found in a sector other than sector zero on this track) are probably part of the 
indirect chain. Examining the sector linkage of the last sector of each track that has 
been identified as containing indirect access file data can be used to establish the 
ordering of these tracks. Note that if the last sector of an indirect chain track is a 
system sector, byte NSSS contains the pointer to the next track. Alternatively, the 
PFCs on the catalog tracks can be examined to determine the tracks that are on the 
indirect chain and the ordering of these tracks. 

Instances in which multiple tracks are linked to a single track in the track recovery 
table must be resolved in order to correctly build the TRT. Note that the BLDSTRT 
command will inform you of these conflicts. You must inspect the contents of the 
various tracks and make an empirical judgment as to the correct linkage. 

The SETRW and SETTP commands must be used to eliminate the conflicting linkage. 
If a track is to be left unreserved, its track recovery word should be zeroed. 

Flawed tracks may be indicated by setting the flawed track indicator (FL flag) in the 
track recovery word for that track. 
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PACKER Utility K 

The PACKER utility enables you to manage holes within the indirect access permanent file 
chain (IAPF chain) on a permanent file device. This chain is the set of tracks that contains 
all the indirect access permanent files on a permanent file device. Space within the chain is 
allocated to individual files. 

Holes are the spaces created within the IAPF chain when indirect access permanent files 
are deleted. These spaces may be reused later for other indirect access permanent files; 
however, over time these spaces tend to become fragmented into smaller and smaller pieces. 
Eventually, a large amount of space may be in small, unusable holes. 

The PACKER utility reorganizes the IAPF chain so that more of the holes are available for 
storage. It combines adjacent holes, moves files to allow holes to be combined, and releases 
entire tracks when possible. These actions make more tracks available on the device 
(relieving a TRACK LIMIT condition, if one exists) as well as making the remaining holes 
larger and thus more usable. 

Operational Overview 

A single call to the PACKER utility only processes a single permanent file device, but you 
can process multiple devices at the same time by calling a different copy of PACKER for 
each device. 



NOTE 



PACKER sets the PF Utility Interlock while it is processing a device. This prevents any 
access to files on that device by PFDUMP, PFLOAD, or PFM. 

PACKER begins processing a device by reading all the permanent file catalog entries (PFC 
entries) on the specified device and building a set of tables that allows it to operate on the 
IAPF chain in sequential order. PACKER then scans the IAPF chain from the be ginn i ng , 
searching for holes. 

Lost Space Processing 

If PACKER encounters any lost space during its scan, it attempts to reclaim the space for 
future use. Lost space is a condition where space exists on the IAPF chain that is not 
pointed to by a permanent file catalog (PFC) entry. Without a PFC entry, the permanent 
file manager (PFM) is unaware of the space. Lost space is usually the result of a previous 
PACKER run being interrupted by a system failure. 

If the lost space is preceded by or followed by a hole, PACKER merges the lost space with 
one of the holes. If the lost space is preceded by a file and not followed by a hole, PACKER 
creates a new PFC entry for it, transforming it into a normal IAPF hole. If the lost space is 
smaller than the absolute minimum IAPF hole size of three PRUs, it cannot be reclaimed 
and is left as lost space. 
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Hole Processing 

When PACKER encounters a hole during its scan, a sequence of events begins. Unless the 
collection hole is already open, the newly found hole is turned into the collection hole. The 
collection hole is the focal point of the major operations of combining holes and moving files. 
The PFC pointing to the collection hole is changed into a purged direct access permanent 
file (DAPF) PFC. This PFC is changed back into an IAPF PFC pointing to the hole when the 
collection hole is changed back into a normal hole; until that occurs, the collection hole is 
lost space. 

PACKER uses this procedure to provide for system failures during PACKER operation. If 
such a failure occurs, the system is unaware of the changes PACKER is making, all files are 
intact, and the lost space is recovered the next time PACKER is run. 

The following sequence is repeated until the collection hole is closed. 

1. Any holes following the collection hole have their PFCs changed into purged DAPF 
PFCs and their space is added to the collection hole. This combining of contiguous holes 
is continued until PACKER encounters a file. 

2. When a file is encountered, PACKER checks to see if the collection hole is big enough 
for tracks to be delinked from it. If so, it delinks and returns the tracks to the system. 
This premove delinking limits the amount of data (files) that are moved by limiting the 
size of the collection hole. 

3. The utility looks for the largest file that fits into the collection hole by starting from the 
end of the IAPF chain and scanning toward the current position. If it finds such a file, 
PACKER copies the file to the beginning of the collection hole, updates its PFC to point 
to the new position, and updates the collection hole's starting address and length. (This 
is called the fill-move technique.) 

If the collection hole is completely filled, PACKER considers it closed and begins 
scanning again. If the move is successful, PACKER repeats it until no further files can 
be moved using the fill-move technique. 

4. The file adjacent to the collection hole (which was excluded from the fill-move search) is 
then examined to see if it can be slid across the collection hole. This file must 
completely fit within the collection hole, for the file would be destroyed if the file was 
copied on top of itself and the system failed during the copy. 

PACKER examines the sizes of all the files until the next hole to ensure that they fit in 
the collection hole (if any do not fit, the effect of the moves would only be to move the 
position of the hole, which in itself is of no benefit). 

If all the files fit, PACKER copies them, one by one, across the collection hole, and 
updates the address of the collection hole. (This is called the slide-move technique.) 
PACKER combines the newly adjacent hole with the collection hole and resumes 
scanning. If all the files between the collection hole and the next hole do not fit into the 
collection hole, PACKER closes the collection hole and scans for the next hole. 

5. PACKER terminates the scan when it encounters the end of the IAPF chain. If the 
collection hole is open, PACKER drops it off the end of the IAPF chain by adjusting the 
EOI. 
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Dayfile Statistics 

At termination, PACKER issues the following set of statistical dayfile messages. These 
messages document the original state of the device, changes made by PACKER, final state 
of the device, and resources used by PACKER. 



ONSET FILES 
ONSET HOLES 
FILL MOVES 
SLIDE MOVES 
FILES MOVED 
LOST SPACE 
HOLES LEFT 
HOLES FREED 
TRACKS FREED 
FLAW SPACE 
SRUS 

CPU SECONDS 
MAXIMUM CM FL 
MANAGED TABLE 



NNNNNN, SSSSSS PRUS. 
NNNNNN, SSSSSS PRUS. 
NNNNNN, SSSSSS PRUS. 
NNNNNN, SSSSSS PRUS. 
NNNNNN, SSSSSS PRUS. 
NNNNNN, SSSSSS PRUS. 
NNNNNN, SSSSSS PRUS. 
NNNNNN, SSSSSS PRUS. 
NNNNNN, SSSSSS PRUS. 
NNNNNN, SSSSSS PRUS. 

23456.890 UNTS. 

23456.890 SECS. 

234567890 SCM. 
MOVES 234567890 UNTS. 
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Command Format 

The PACKER command calls the utility that reorganizes the indirect access permanent files 
on a specified permanent file device. The command has the following format: 

PACKER, p 1 =f 1 ,p 2 =f 2 , . . . ,p n =f n . 

Pl Description 

DN=devicenumber Device number. This parameter is required if a family device is to 

be processed. It cannot be used with the PN parameter. 

FM=familyname Family name. This parameter cannot be used with the PN 

parameter. If you omit both the FM and PN parameters, 
PACKER processes the system default family. 

NM No moves. If you specify this parameter, PACKER does not move 

any files; it limits its work to the combining of contiguous holes 
and the reclamation of lost space. Since this parameter greatly 
decreases the time required to run PACKER, you can use it when 
attempting to relieve a TRACK LIMIT condition during 
production hours. 

PN=packname Pack name. This parameter is required if the device to be 

processed is an auxiliary pack. This parameter cannot be used 
with the FM or DN parameter. 

TL=timelimit Time limit. If you specify this parameter, PACKER stops running 

after the specified number of seconds (wall clock time). If a value 
is specified, the system assumes it is octal. If the TL parameter is 
specified but not equivalenced (that is, TL is specified without a 
value), the system uses a limit of 300D. 

The following command parameters are not needed for normal operations, but may be 
useful in special situations. 

Pj Description 

EF Exact fit. If you specify this parameter, an exact fit is required 

when moving a file with the fill-move technique. Use of this 
parameter might increase the number of files moved using the 
slide-move technique, which can result in more space being 
released to the operating system at the expense of moving an 
increased number of files. 

IX=index Index. This parameter specifies the starting index into PACKER'S 

sorted PFC table. You can use it to skip the specified number of 
PFC entries before beginning processing. In some situations, this 
parameter provides a useful method of shortening the execution 
time of PACKER. If a value is specified, the system assumes it is 
octal. (The use of this parameter has an impact on the end-of-run 
statistics, since they do not reflect the portion skipped.) 
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MR=moveratio Move ratio. This parameter specifies the maximum ratio between 

the total length of the files to be moved in a slide move and the 
size of the hole into which the files are to be moved. A value of 
prevents all files from being moved using the slide-move 
technique; however, it is recommended that you use the NS 
parameter instead of MR=0. If a value is specified, the system 
assumes it is octal. If you omit the MR parameter, the system 
uses a value of 100B for the move ratio; if the MR parameter is 
specified, but not equivalenced, the system uses a value of 
377777B. 

NC No changes. If you specify this parameter, PACKER determines 

what operations ought to be performed in response to the other 
specified parameters, but does not actually make any changes to 
the device. 

Since PACKER still issues dayfile messages at termination 
detailing the changes that would have been made, you may use 
this option to preview the potential effect of a parameter setting. 
You can compare alternative parameter combinations to 
determine the best way to reach a desired result. 

NF No fill moves. If you specify this parameter, PACKER does not 

move any files using the fill-move technique. Use of this 
parameter forces all files to be moved using the slide-move 
technique. This can result in more space being released to the 
operating system at the expense of moving an increased number 
of files. 

NP No premove delinks. If you specify this parameter, PACKER does 

not delink tracks before attempting to move files. Delinking 
tracks before moving files limits the size to which the collection 
hole is allowed to grow, which in turn limits the amount of data 
moved by PACKER in its attempts to fill the collection hole. These 
delinks might shorten the time PACKER executes at the expense 
of possibly leaving small holes where tracks were delinked. 

This parameter does not affect the delinking of tracks from holes 
that remain after PACKER has completed its work. 

NS No slide moves. If specified, PACKER does not move any files 

using the slide-move technique. This might increase the speed of 
PACKER execution by leaving more holes unfilled. You may also 
use the MR parameter to control slide moves in a more general 
fashion; however, to totally disable slide moves, you should use 
the NS parameter rather than specifying MR=0. 
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The following examples illustrate how you can use the PACKER utility to perform periodic 
maintenance on permanent file devices. 

Example 1: 

For normal periodic maintenance, the PACKER utility can be executed when the production 
load is light and there is little interactive usage. For example, a site might want to use the 
following command every day in the early morning: 

PACKER ( FM= f f f f f f , DN=nn ) 

Example 2: 

To get some space on a device that is at or near track limit, PACKER Can be run quickly 
even during active production hours by specifying the NM parameter. Specifying this 
parameter reduces the amount of space reclaimed, but also greatly reduces the amount of 
time required to run PACKER. The following command may be entered: 

PACKER (FM=fffff f , DN=nn, NM) 

Example 3: 

If a site determines that daily PACKER runs have too great an impact on production, the 
site can specify the NM parameter (as in example 2) when running PACKER on weekdays, 
and only do full PACKER runs (as in example 1) once a week. 
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Known media defects 1-3 

Management 11-78 

Release 12-8 

Disk thresholds display 2-19 

DISK VALIDATION IPRDECK entry 3-123 
Display disk file (see DDF) J-l 



60459300 U 



NOS Version 2 Analysis Handbook Index-5 



Display selection commands (DIS) - 4-13 
Display selection commands (DSD) . 5-2 

DISPOSE DSDI directive 6-9 

DMPCCC utility 1-4 

DMPNAD command 14-1 

Documentation 

Audience 13 

Conventions 14 

Organization 13 

Related publications 15 

Software support hotline 20 

Submitting comments 20 

DOP 

Commands 15-45 

Network control 15-41 

Responsibilities 15-41 

Status message formats .... 15-43 
Unsolicited status reports . . . 15-45 

DOWN channel entry 3-79 

DOWN DSD command 5-25 

DOWN EQPDECK entry 3-79 

DP DSDI directive 6-29 

DROP DIS command 4-14 

DROP DSD command 5-5 

DSD commands 

99 5-69 

ACN 5-74 

ASSIGN 5-24 

AUTO 5-56 

BIO 5-50 

BKP 5-76 

BKSP 5-24 

BKSPF 5-25 

BKSPRU 5-25 

Categories 5-1 

CDCffiT 5-50 

CFO 5-9 

CFR 5-75 

CHECK POINT SYSTEM .... 5-56 

CKP 5-4 

CLASS 5-10 

COMMENT 5-9 

CONTINUE 5-25 

CPB 5-80 

CPTT 5-11 

CYBfiff 5-50 

DATE 5-57 



DCH 5-74 

DCN 5-74 

DEBUG 5-58 

DELAY 5-11 

Description 5-1 

DIAL 5-8 

DIS 5-58 

DISABLE 5-59 

DOWN 5-25 

DROP 5-5 

END 5-27 

ENPR 5-5 

ENQP 5-5 

FCN 5-74 

FORM 5-27 

GO 5-9 

IAFffff 5-50 

IAN 5-74 

ID 5-27 

IDLE 5-28,5-52,5-64 

IDLEFAMILY 5-29 

INITIALIZE 5-30 

K 5-64 

KILL 5-6 

L 5-64 

LDC 5-74 

LOAD 5-32 

LOCK 5-64 

MAGffif 5-52 

MAINTENANCE 5-65 

MAPflff 5-52 

MCH 5-74 

MCSffif 5-52 

MOUNT 5-33 

MSAL 5-34 

MSEfiff 5-53 

NAMffiff 5-53 

NEXTVSN 5-35 

OAN 5-74 

OFF 5-36 

OFFSW 5-9 

ON 5-37 

ONSW 5-9 

OQSH 5-70 

OVERRIDE 5-6 

PAUSE 5-9 
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PCLASS 5-13 

PRSIZE 5-37 

QUEUE 5-14 

RDFffif 5-53 

RELEASE 5-70 

REPEAT 5-37 

REPRINT 5-38 

REPUNCH 5-38 

RERUN 5-7 

RETRY 5-38 

RHFffif 5-54 

ROLLIN 5-7 

ROLLOUT 5-7 

SCHEDULE 5-65 

SCRATCH 5-39 

SECUREQ 5-39 

SECURES 5-70 

SERVICE 5-17 

SFR 5-75 

SKIP 5-39 

SKIPF 5-39 

SKIPRU 5-40 

SMFfiff 5-54 

SPINDOWN 5-40 

SPINUP 5-40 

SRST 5-22 

STEP 5-65 

STMffff 5-54 

STOP 5-40, 5-54 

SUPPRESS 5-41 

TAFffff 5-55 

TEMP 5-41 

TERMINATE 5-41 

THRESHOLD 5-42 

TIME 5-66 

TRACE 5-84 

TRAIN 5-43 

TRAP 5-87 

UNLOAD 5-45 

UNLOCK 5-67,5-71 

UNSTEP 5-68 

UP 5-47 

V 5-77 

VALIDATE 5-47 

VSN 5-47 

WARN 5-8 

X 5-68 



X.AFD 5-3 

X.DFD 5-3 

X.ELD 5-3 

X.MDD 5-68 

XQMOVE 5-4 

X.QREC 5-4 

DSD IPRDECK entry 3-124 

DSD V display 5-77 

DSDI 

Buffer controller directive .... 6-51 

CMR dump directives 6-24 

Command 6-3 

Description 6-1 

Directive format 6-7 

Dump control directives 6-11 

Examples 6-60 

Features 6-1 

File manipulation and control 

directives 6-9 

Hardware register dump directives 6-43 

Input directives 6-6 

Interactive use 6-52 

List control directives 6-8 

Memory dump directives 6-14 

PP dump directives 6-17 

Subsystem dump/analysis directives 6-39 

Terminal output directives .... 6-54 

DSDI directives 

* 6-9 

ACCOUNT 6-24 

ALLMEM 6-11 

AP 6-17 

B 6-24 

BATCHIO 6-39 

BCDUMP 6-51 

BIO 6-39 

C 6-14 

CBT 6-25 

CCT 6-25 

CM 6-11 

CP 6-26 

CPO 6-28 

CT 6-28 

D 6-14 

DAYFILE 6-28 

DB 6-28 
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DBW 6-29 

DDB 6-29 

DISPOSE 6-9 

DP 6-29 

E 6-15 

EC 6-12 

EICB 6-29 

EJ 6-8 

EJOFF 6-8 

EJON 6-8 

EJT 6-30 

EPB 6-30 

ERRLOG 6-30 

EST 6-30 

FMFREG 6-43 

FNT 6-30 

FOT 6-31 

HAT 6-31 

I 6-15 

IAF 6-40 

IOUCR 6-43 

IOUMR 6-43 

JC 6-31 

LC 6-31 

LDIS 6-32 

LIDT 6-32 

LPVA 6-44 

MAG 6-41 

MAGNET 6-41 

MAINLOG 6-32 

MCT 6-32 

MEMMR 6-44 

MPP 6-18 

MST 6-33 

MTR 6-33 

MTRQUEUE 6-34 

ODIS 6-34 

OUTPUT 6-9 

P 6-18 

PCP 6-34 

PD 6-8 

PF 6-19 

PLD 6-35 

PMS 6-19 

PO 6-20 

PP 6-35 

PROBE 6-35 



PROCA 6-45 

PROCW 6-45 

PROMR 6-45 

PROPM 6-46 

PRORF 6-46 

PROSM 6-46 

PROXP 6-47 

PST 6-35 

PUT 6-36 

PX 6-20 

Q 6-21 

QF 6-21 

QFT 6-36 

QOA 6-22 

QOD 6-22 

QXA 6-23 

QXD 6-23 

RA 6-12 

RAC 6-13 

RCL 6-36 

READ 6-10 

REWIND 6-10 

RHF 6-42 

RPL 6-37 

SAB 6-37 

SC 6-47 

SECDED 6-37 

SETCPU 6-47 

SETIOU 6-48 

SETJPS 6-48 

SETRMA 6-49 

SETVEP 6-49 

SST 6-38 

TBDUMP 6-38 

TRACEBK 6-50 

UEC 6-13 

W 6-16 

XP 6-50 

Dual-channel access 3-53 

Dual-state,NOS-NOS/VE 10-7 

Dump 

Full 11-81, 17-74 

Incremental 11-82, 17-73 

Partial 17-74 

Secured system 17-73 

Tape management 11-82 
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Dump NAD memory 

Description 14-1 

Local NAD dumping 14-2 

Remote NAD dumping 14-2 

Dump permanent file (PFDUMP) . 17-72 

E 

E DSDI directive 6-15 

EC DSDI directive 6-12 

EI IPRDECK entry 3-125 

EICB DSDI directive 6-29 

EJ DSDI directive 6-8 

EJOFF DSDI directive 6-8 

EJON DSDI directive 6-8 

EJT CMRDECK entry 3-4 

EJT DSDI directive 6-30 

Electronic vertical format unit (see 

EVFU) F-l 

ELS DIS command 4-14 

EMB CMRDECK entry 3-4 

Enable application command . . . 15-16 
Enable network element command 15-32 

Enable subsystems 3-136 

ENABLE,subsystem IPRDECK entry 3-136 

ENAi DIS command 4-14 

ENBi DIS command 4-14 

END DSD command 5-27 

ENEM DIS command 4-14 

ENFL DIS command 4-14 

ENFLE DIS command 4-15 

Engineering mode 3-143 

ENGR IPRDECK entry 3-143 

ENP DIS command 4-15 

ENPR DIS command 4-15 

ENPR DSD command 5-5 

ENQP DSD command 5-5 

ENS DIS command 4-15 

ENTER DIS command 4-15 

ENTL DIS command 4-15 

ENXi DIS command 4-15 

EPB DSDI directive 6-30 

EQP CMRDECK entry 3-4 

EQPDECK 

Description 3-13 

Display 2-3 

Entries during deadstart 3-96 

Listing 3-13 



Modifying 2-3 

Restrictions 3-14 

EQPDECK entries 

ACCESS 3-94 

ACCOUNT 3-15 

ASR 3-85 

AUTOLOAD 2-4 

DAYFILE 3-16 

DOWN 3-79 

ERRLOG 3-16 

FAMILY 3-86 

GRENADE 2-4 

INITIALIZE 2-4 

ISHARE 3-89 

LBC 3-90 

MAINLOG 3-17 

MAXSHARE 3-88 

MSAL 3-77 

PF 3-80 

PRESET 3-101, 2-7 

REMOVE 3-86 

RESET 3-102,2-7 

SCKP 3-85 

SHARE 3-87 

SYSTEM 3-84 

THRESHOLD 3-95 

UEMIN 3-93 

UP 3-79 

XM 3-92 

EQPINST 

Description 3-13 

EQPINST display 2-8 

Equipment assignments 

Clearing 3-18 

Entries 3-18 

Mass storage 3-40 

Nonmass storage 3-21 

Equipment status display 2-8 

ERR DIS command 4-15 

ERRLOG DSDI directive 6-30 

ERRLOG EQPDECK entry .... 3-16 

Error idle recovery 2-43 

Error log 3-16 

Error processing 

Deadstart from disk 2-36 

Deadstart from tape 2-35 
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Error idle recovery 2-43 

Recovery functions 2-36 

EST DSDI directive 6-30 

EST entries 

6683 satellite coupler 3-37 

CDCNET device interface .... 3-34 

Control module 3-65 

CYBERPLUS ring port 3-38 

Disk equipment 3-58 

Extended memory 3-66 

Magnetic tape equipment .... 3-27 

MAP equipment 3-37 

MSE 3-30 

Network access device 3-35 

Network processing unit 3-32 

Nonstandard equipment 3-21 

Optical disk 3-39 

Pseudoequipment 3-22 

Stimulator equipment 3-31 

Two-port multiplexer 3-36 

Unit record equipment 3-23 

EST ordinal ranges 3-58 

EVFU 

Description F-l 

Directives for 533/536 printers . . F-l 

Format control characters .... F-2 

Format control directives .... F-l 

Load file example F-3 

Load image F-5 

Exchange package display (X) ... 4-8 

Extended core storage 3-55 

Extended memory 

Clearing 3-126 

EST entry 3-66 

Examples 3-70 

Field length 3-155 

Flag registers 5-75 

Logical configuration 3-56 

Overview 3-55 

Physical configuration 3-55 

Reserve for buffers 3-92 

Simultaneous usage 3-57 

UEMsize 3-57 

User 3-160 

Extended semiconductor memory . . 3-55 

EXTENDED STACK PURGING 

IPRDECK entry 3-125 



F 

Family device 3-45 

FAMILY EQPDECK entry 3-86 

Family name assignment entry . . . 3-86 

FCN DSD command 5-74 

File dumping 11-81 

File reloading 11-84 

Flaw entries 

CLF 8-5 

CPF 8-5 

SLF 8-5 

SPF 8-5 

FLAW K display 8-3 

FLEXIBLE PARTITIONS IPRDECK 

entry 3-143 

FMFREG DSDI directive 6-43 

FNT CMRDECK entry 3-5 

FNT DSDI directive 6-30 

FORCED FORMATTING IPRDECK 

entry 3-144 

FORM DSD command 5-27 

FORMAT command G-2 

FOT CMRDECK entry 3-5 

FOT DSDI directive 6-31 

FOTDL display 9-2 

G 

GENPFD 

Command 12-12 

File selection processing .... 12-16 

Input directives 12-13 

Limitations 12-16 

GO DIS command 4-15 

GO DSD command 5-9 

GRENADE EQPDECK entry .... 2-4 
Group 11-12 

H 

HARDWARE FAULT INJECTION 

IPRDECK entry 3-125 

HAT DSDI directive 6-31 

HOLD DIS command 4-15 

HOP 

Commands 15-11 

Control commands 15-56 
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Network control 15-9 

Status message formats 15-9 

Unsolicited status reports . . . 15-10 
Host operator (see HOP) 15-11 

I 

I DSDI directive 6-15 

IAF 
Control point assignment . . . 3-136 

IAF DSDI directive 6-40 

IAF IPRDECK entry 3-136 

IAF stimulator 

Description 16-33 

Dynamic login 16-39 

Multiple sessions 16-46 

Parameter output 16-46 

Postprocessing 16-48 

Session file 16-34, 16-42 

STIMULA command 16-34 

Task definitions 16-41 

Think time 16-40 

IAFfffF DSD command 5-50 

IAFTM procedure file 16-29 

IAFTR procedure file 16-30 

IAN DSD command ........ 5-74 

ID DSD command 5-27 

IDLE DSD command . . 5-28, 5-52, 5-64 
Idle host element command . . . 15-16 
IDLEFAMILY DSD command . . . 5-29 

INB CMRDECK entry 3-6 

Independent SDM operation 

Checkpoint 13-17 

CMRDECK entry 13-11 

Deadstart 13-11 

Description 13-11 

EQPDECK entry 13-11 

MSE 13-17 

Recovery 13-16 

Unload 13-16 

Independent shared device entry . . 3-89 

Indirect access files 3-46 

Initialization entry 3-96 

INITIALIZE command 8-8 

INITIALIZE DSD command .... 5-30 
INITIALIZE EQPDECK entry ... 2-4 

INITIALIZE K display 8-8 

Initiating job processing 2-25 



INSTALL command 7-1 

Interactive facility (see IAF) . . . 3-136 

Interactive job control commands . . 5-8 

Interactive Stimulator 3-137 

IOUCR DSDI directive 6-43 

IOUMR DSDI directive 6-43 

IPD CMRDECK entry 3-6 

IPRDECK 

Deadstart entries 3-135 

Deadstart only entries 3-120 

Description 3-107 

Display 2-22 

Entries 3-107 

Listing 3-107 

Modifying 2-22 

Subsystem entries 3-135 

IPRDECK entries 

ACS TAPE PF STAGING . . . 3-137 

ATF 3-136 

AUTORESTART 3-138 

BIO 3-136 

CARTRIDGE PF STAGING . . 3-138 

CDC 3-136 

CLASS 3-139 

COMLIB 3-120 

CPM 3-120 

CPTT 3-140 

CSM 3-123 

DDP ROLLOUT PATH .... 3-142 

DEBUG 3-140 

DELAY 3-141 

DFPT 3-142 

DISABLE,subsystem 3-136 

DISK VALIDATION 3-123 

DSD 3-124 

EI 3-125 

ENABLE,subsystem 3-136 

ENGR 3-143 

EXTENDED STACK PURGING 3-125 

FLEXIBLE PARTITIONS . . . 3-143 

FORCED FORMATTING . . . 3-144 

HARDWARE FAULT INJECTION 3-125 

IAF 3-136 

KEYPM 3-126 

LOCK 3-145 

LOGGING 3-145 
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MAG 3-136 

MAP 3-136 

MASTER MSE 3-146 

MCS 3-136 

MEMORY CLEARING .... 3-126 

MICRO 3-127 

MS VALIDATION 3-146 

MSE 3-136 

NAM 3-136 

NAMIAF 3-127 

NVE 3-136 

OQSH 3-147 

PCLASS 3-147 

PF VALIDATION 3-148 

PRIVILEGED ANALYST MODE 3-148 

PRIVILEGED RDF 3-149 

PROBE 3-127 

QUEUE 3-149 

RBF 3-136 

RDF 3-137 

REMOVABLE PACKS 3-151 

RESDDENTRDF 3-151 

RHF 3-137 

SCP 3-128 

SCRSIM 3-128 

SECCATS 3-129 

SECONDARY USER COMMANDS 3-151 

SECURES 3-152 

SERVICE 3-153 

SMF 3-137 

SPC 3-129 

SPD 3-130 

SPFNDOWN 3-158 

SPL 3-130 

SPW 3-130 

SRST 3-158 

SSF 3-137 

STM 3-137 

SUBCP 3-131 

SYSTEM DEBUG 3-159 

TAF 3-137 

TAPE PF STAGING 3-160 

TCVM 3-131 

TDEN 3-132 

TDTY 3-132 

TMS 3-133 

TMSTO 3-133 



TRACE 3-134 

UNLOCK 3-160 

USER EXTENDED MEMORY . 3-160 

IPRINST display 2-22 

ISF command 20-1 

ISHARE EQPDECK entry 3-89 

J 

JC DSDI directive 6-31 

Job communication commands . . . 5-9 
Job control 

Commands 5-4 

Information 3-108 

Parameter example 3-114 

Job dayfile display (A) 4-3 

Job flow commands 5-10 

Job processing 

Initiating 2-25 

Job scheduling 3-108 

Job status display (B) 4-4 

K 

K DSD command 5-64 

K-Display utilities 

FLAW 8-3 

INITIALIZE 8-8 

MREC 8-16 

MSE 8-24 

NAM 8-26 

QTF 8-40 

RBF 8-70 

REDEFINE 8-59 

RHF 8-73 

SSF 8-82 

TAF 8-86 

K-display utilities 

Overview 8-1 

KEYPM IPRDECK entry .... 3-126 

Keypunch mode 3-126 

KILL DSD command 5-6 

L 

L DSD command . 5-64 

L-display utilities 
FOTD 9-2 
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LIDOU 9-3 

QDSPLAY 9-6 

SCTD 9-9 

SDSPLAY 9-11 

SUBSYST 9-19 

Label checking 3-151 

Large central memory extended . . 3-55 

LBC EQPDECK entry 3-90 

LC DSDI directive 6-31 

LCFFILE file 16-31 

LCN examples 10-18 

LDC DSD command 5-74 

LDIS DSDI directive 6-32 

LDLIST routine 18-30 

LDT CMRDECK entry 3-6 

Level recovery deadstart 2-35 

Level 1 recovery deadstart 2-33 

Level 2 recovery deadstart 2-34 

Level 3 recovery deadstart 2-30 

LIB CMRDECK entry 3-6 

LIBDECK 

*/ entry 3-162 

*AD entry 3-161 

*CM entry 3-161 

*FL entry 3-161 

*PROC entry 3-162 

*SC entry 3-162 

LID configuration file 10-1 

LID configuration file creation . . . 10-1 
LID table 

Building or Rebuilding 10-6 

Listing 10-7 

Specifying size 10-6 

LIDOU L display 9-3 

LIDT DSDI directive 6-32 

Link device 3-45 

Linked SDM operation 

Checkpoint 13-10 

CMRDECK entry 13-3 

Configuration 13-3 

Deadstart 13-3 

Description 13-2 

Device access tables 13-6 

EQPDECK entry 13-3 

MSE 13-10 

Recovery 13-9 

Unload 13-9 



Listing NAD dumps 14-3 

LISTLID command 10-7 

Load buffer controllers entry .... 3-90 

LOAD DSD command 5-32 

Load file generator 

Description 16-8 

Input directives 16-9 

Load partition 16-10 

Network load file 16-10 

Summary fisting 16-10 

Load permanent file (PFLOAD) . . 17-76 
LOADBC utility 

Command , 1-1 

Loading microcode 3-127 

Loading the system 2-23 

Local configuration file (LCF) . . 16-31 

LOCK DSD command 5-64 

LOCK IPRDECK entry 3-145 

LOGGING IPRDECK entry . . . 3-145 
LPVA DSDI directive 6-44 

M 

M DIS command 4-15 

Machine recovery utility (see MREC) 8-16 

MAG DSDI directive 6-41 

MAG IPRDECK entry 3-136 

MAGfiEff DSD command 5-52 

MAGNET command 12-11 

MAGNET DSDI directive 6-41 

Magnetic tape equipment EST entry 3-27 
Magnetic tape subsystem (see MAG) 3-136 

MAINLOG DSDI directive 6-32 

MAINLOG EQPDECK entry .... 3-17 
MAINTENANCE DSD command . . 5-65 
Maintenance host facility (MHF) . . 14-2 
Management of storage media defects . 1-1 
MAP 

EST entry 3-37 

IPRDECK entry 3-136 

MAP III or D7 3-136 

MAP III or D7 equipment EST entry 3-37 

MAPfiEEf DSD command 5-52 

Mass Storage 

Allocation control entry 3-77 

Mass storage 

Clear logical flaws 3-105 
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Concepts 3-41 

Configuration example 3-43 

Device functions 3-42 

Device recovery table 2-37 

Equipment assignments 3-40 

Hardware verification 3-123 

Initialization status display . . . 2-16 

Set logical flaws 3-105 

Status display 2-12 

Thresholds 1-2 

Validation 3-146 

Mass storage extended subsystem (see 

MSE) 3-30 

Mass storage table 17-9 

Master device 

Concepts 3-45 

Master mode, MSE executive . . . 3-146 
MASTER MSE IPRDECK entry . 3-146 
Matrix algorithm processor (see MAP) 3-37 
Maximum shared device entry . . . 3-88 
MAXSHARE EQPDECK entry . . . 3-88 

MCH DSD command 5-74 

MCS 

IPRDECK entry 3-136 

MCSfHF DSD command 5-52 

MCT DSDI directive 6-32 

MEMMR DSDI directive 6-44 

Memory clearing 3-126 

MEMORY CLEARING IPRDECK entry 

3-126 

Memory control 3-113 

Memory displays (DIS) 4-6 

Memory entry commands (DIS) . . . 4-18 
Memory entry commands (DSD) . . 5-72 

Message control system 3-136 

Messages, DIS 4-11 

MICRO IPRDECK entry 3-127 

MID CMRDECK entry 3-6 

MINCM CMRDECK entry 3-7 

MOUNT DSD command 5-33 

MPP DSDI directive 6-18 

MREC 

Commands 8-20 

K display 8-16 

Parameters 8-20 

Procedures 8-17 

Unit and controller reservations . 8-22 



MS VALIDATION IPRDECK entry 3-146 

MSAL DSD command 5-34 

MSAL EQPDECK entry 3-77 

MSE 

EST entry 3-30 

Introduction 11-1 

IPRDECK entry 3-136 

Operational procedures .... 11-77 

Utilities H-2 

Utility terminology 11-3 

MSE commands 8-24 

MSE K display 8-24 

MSE processing 
7990 space management .... 11-79 

Backup and recovery 11-81 

Corrective actions 11-85 

Disk space management .... 11-78 

Error conditions 11-85 

Initialization 11-77 

MSE utilities 

SSALTER H-74 

SSBLD H-70 

SSDEBUG H-59 

SSDEF 11-13,11-14 

SSMOVE H-24 

SSUSE H-51 

SSVAL H-40 

MSEffiT DSD command 5-53 

MST DSDI directive 6-33 

MTR DSDI directive 6-33 

MTRQUEUE DSDI directive .... 6-34 
Multimainframe operation 

Deadstart 13-3 

Description 13-1 

Multispindle device 3-46 

N 

N DIS command 4-15 

NAD 

Controlware 1-2 

EST entry 3-35 

NAD maintenance utilities 14-1 

NAM 
Configuration file directives . . 10-21 

Initialization 15-1, 16-1 

IPRDECK entry 3-136 
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Procedure file 16-1 

Shutdown 15-8 

Startup 15-5 

NAM K display 

Control characters 8-28 

Fields 8-26 

Operation 8-29 

NAM mode commands 8-29 

NAM mode maintenance commands 

DB 8-31 

DE 8-32 

DU 8-32 

FL 8-33 

LB 8-33 

LE 8-34 

LR 8-34 

RS 8-35 

ST 8-36 

NAME CMRDECK entry 3-8 

NAMffff DSD command 5-53 

NAMIAF IPRDECK entry .... 3-127 
NAMNOGO 

Procedure file 16-2 

NCF 

APPL statement 10-11 

CHARGE statement 10-17 

DEBUG statement 10-16 

Examples 10-18 

File 16-31 

LNAD statement 10-14 

LNDR statement 10-11 

NPID statement 10-13 

PATH statement 10-13 

RNAD statement 10-16 

Statements 10-11 

NCFFILEfile 16-31 

NCP CMRDECK entry 3-8 

NCTFifile 16-31 

NDA 

Description 16-11 

Dump interpretation 16-28 

Input directives 16-12 

NPU dump files 16-28 

Output file content 16-27 

Parameters 16-11 

Sample output 16-16 

Network 



CDCNET 15-1 

Command summary 15-56 

Description files 16-31 

Operations 15-1 

Organization 15-1 

Processing units (NPUs) 15-1 

Supervisor (NS) 15-1 

Network Access Device (see NAD) . 1-2 

Network access device (see NAD) . . 14-1 

Network access method (see NAM) 3-136 

Network commands 

COLLECT 16-5 

DEMUX 16-49 

IAFEX 16-29 

LFG 16-8 

LISTPPM 16-28 

NAMI 16-2 

NDA 16-11 

STIMULA 16-34 

Network configuration file (see NCF) 10-10 

Network control 

DOP 15-41 

HOP 15-9 

NOP 15-21 

Network dump collector 16-5 

Network operation commands 

ALERT 15-26 

CFO 15-7 

CONTROL 15-27 

DISABLE 15-15,15-29 

DUMP 15-39 

ENABLE 15-16, 15-32 

FILE 15-12 

GO 15-36 

HISTORY 15-49 

IDLE 15-58 

INFO 15-46 

LOAD 15-37 

NAM 15-5 

NAMNOGO 15-6 

NOFILE 15-11 

REPORT 15-50 

SEND 15-40, 15-51 

STATUS 15-12, 15-52 

Summary 15-56 

TST 15-47 
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Network operator utility (NETOU) . 15-1 

Network processing unit EST entry . 3-32 

NEXTVSN DSD command 5-35 

NLID statement 10-3 

Node/path linkage statements . . 11-70 

Nonremovable mass storage device . 3-51 

Nonstandard equipment EST entry . 3-21 
NOP 

ALERT command 15-26 

Commands 15-26 

CONTROL command 15-27 

DISABLE command 15-29 

ENABLE command 15-32 

Network control 15-21 

Responsibilities 15-21 

SEND command 15-40 

Status message formats .... 15-23 

Unsolicited status reports . . . 15-25 

NOS/VE address formats H-l 

NOS/VE Dual-state interface . . . 3-136 

NPID statement 10-2 

NPU 

Alternate load file command . . 15-11 

Diagnostic test command . . . 15-47 

DUMP command 15-39 

GO command 15-36 

LOAD command 15-37 

Load file command 15-12 

Load status command 15-12 

NPU dump analyzer (see NDA) . . 16-11 

NS control commands 15-11 

NS recent HISTORY command . . 15-14 

NVE IPRDECK entry 3-136 

NVF control commands 15-15 

NVF recent HISTORY command . 15-18 

o 

026 DIS command 4-16 

OAN DSD command 5-74 

ODIS DSDI directive 6-34 

OFF DSD command 5-36 

OFFSW DIS command 4-16 

OFFSW DSD command 5-9 

ON DSD command 5-37 

ONSW DIS command 4-16 

ONSW DSD command 5-9 

Operation under DIS 4-1 



OPSECM CMRDECK entry .... 3-9 

Optical disk 12-1 

Optical disk EST entry 3-39 

OQSH DSD command ....... 5-70 

OQSH IPRDECK entry 3-147 

Origin type 3-139 

OUTPUT DSDI directive 6-9 

Output queue special handling level 3-147 
OVERRIDE DSD command .... 5-6 

P 

P DSDI directive 6-18 

Pack reformatting, 844 
Access for read and write .... G-12 

Access for read only G-ll 

Pack reformatting, 881/883 

Control directives G-4 

Data statements G-5 

Description G-l 

Examples G-7 

FORMAT command G-2 

Input formats G-4 

Output formats G-6 

PACKER command K-4 

PACKER utility 

Command format K-4 

Dayfile statistics K-3 

Description K-l 

Examples K-6 

Hole processing K-2 

Lost space processing K-l 

Operational overview K-l 

PAUSE DSD command 5-9 

PCLASS DSD command 5-13 

PCLASS D7RDECK entry .... 3-147 

PCP CMRDECK entry 3-9 

PCP DSDI directive 6-34 

PD DSDI directive 6-8 

Peripheral equipment control commands 

5-24 

Permanent file catalog 

Analysis 11-45 

Entry 17-11 

Format 17-11 

Problems 11-87 

Permanent file commands 
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FAMILY 17-26 

PFATC 17-67 

PFCAT 17-67 

PFCOPY 17-72 

PFDUMP 17-72 

PFLOAD 17-76 

PFREL 17-89 

Permanent file recovery 11-85 

Permanent files 

Device assignment 3-80 

Permit information 3-46 

PF DSDI directive 6-19 

PF EQPDECK entry 3-80 

PF utilities 

Batch input 17-43 

Calling 17-36 

Console input 17-36 

DIS input 17-43 

List 17-2 

Overview 17-1 

Parameters 17-45 

Procedure files 17-44 

Routines 17-62 

Summary file 17-29 

Terminal input 17-44 

Terminology 17-2 

PF VALIDATION IPRDECK entry 3-148 
PFDUMP 
Alternate storage environment . 17-74 

Description 17-72 

Example 17-82 

File interlocking 17-74 

Full 17-74 

Incremental 17-73 

Partial 17-74 

Protected files 17-76 

Secured system 17-73 

PFLOAD 
Alternate storage environment . 17-82 

Catalog image record 17-78 

Description 17-76 

Example 17-82 

Family reconfiguration .... 17-81 

Selection process 17-79 

PIP dump analyzer 16-28 

PLD DSDI directive 6-35 

PMS DSDI directive 6-19 



PO DSDI directive 6-20 

PP breakpoint 

Commands 5-75 

Precautions 5-79 

V display 5-77 

PP call commands (DIS) 4-20 

PP DSDI directive 6-35 

PPU CMRDECK entry 3-10 

Preserved file validation 3-148 

PRESET EQPDECK entry . . 3-101, 2-7 

Preset independent shared device entry 

3-102 

Preset link device entry 3-101 

Primary VSN 12-2 

PRIVILEGED ANALYST MODE 

IPRDECK entry 3-148 

PRIVILEGED RDF IPRDECK entry 3-149 

PROBE command 21-36 

PROBE DSDI directive 6-35 

PROBE IPRDECK entry 3-127 

PROBE utility 

Conditions monitored 21-36 

Description 21-36 

Example 21-38 

PROCA DSDI directive 6-45 

PROCW DSDI directive 6-45 

Program storage display (G) .... 4-7 
Programmable format control arrays 

Adding E-3 

Building E-2 

PROMR DSDI directive 6-45 

PROPM DSDI directive 6-46 

PRORF DSDI directive 6-46 

PROSM DSDI directive 6-46 

PROXP DSDI directive 6-47 

PRSIZE DSD command 5-37 

Pseudo-control points 

Number 3-111 

Usage 3-111 

Pseudoequipment EST entry .... 3-22 

PST DSDI directive 6-35 

PUT DSDI directive 6-36 

PX DSDI directive 6-20 

Q 

Q DSDI directive 6-21 
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QALTER routine 18-30 

QDSPLAY commands 9-7 

QDSPLAY L display 9-6 

QDUMP routine 18-36 

QF DSDI directive 6-21 

QFT CMRDECK entry 3-10 

QFT DSDI directive 6-36 

QFTLIST routine 18-40 

QLIST routine 18-40 

QLOAD routine 18-41 

QMOVE routine 18-44 

QOA DSDI directive 6-22 

QOD DSDI directive 6-22 

QREC routine 18-49 

QTF 
Configuration requirements . . 10-20 

Procedure file 10-22 

QTF K display 

Commands 8-46 

File selection criteria 8-43 

File selection process 8-40 

File size index values 8-43 

NAM operation 8-45 

RHF operation 8-44 

Selection classes 8-40 

Usage 8-44 

QTF K display commands 

CLASS 8-47 

DISABLE 8-48 

ENABLE 8-48 

HELP 8-49 

IDLE 8-49 

INCLUDE 8-50 

SCHED 8-51 

STATUS 8-52 

QUEUE DSD command 5-14 

Queue file transfer facility (see QTF) 8-40 
QUEUE IPRDECK entry .... 3-149 
Queued file commands 

DFLIST 18-27 

DFTERM 18-27 

LDLIST 18-30 

QALTER 18-30 

QDUMP 18-36 

QFTLIST 18-40 

QLIST 18-40 

QLOAD 18-41 



QMOVE 18-44 

QREC 18-49 

Queued file utilities 

Batch input 18-11 

Calling 18-2 

Console input 18-2 

Overview 18-1 

Parameters 18-11 

Preassignment 18-26 

Routines 18-27 

Terminal input 18-11 

Queued file utility 
Commands 5-4 

QXA DSDI directive 6-23 

QXD DSDI directive 6-23 

R 

RA DSDI directive 6-12 

RAC DSDI directive 6-13 

RBF 

IPRDECK entry 3-136 

K display 8-70 

RCFGEN utility 10-8 

RCL DSDI directive 6-36 

RCP DIS command 4-16 

RCS DIS command 4-16 

RDF 

IPRDECK entry 3-137 

Port number 3-36 

Privileged mode 3-149 

Resident mode 3-151 

RDFffff DSD command 5-53 

READ DSDI directive 6-10 

Recent HISTORY command 

Description 15-49 

NS command 15-14 

NVF command 15-18 

Reconfiguration 

Commands 8-64 

Equipment requirements .... 8-59 

Parameters 8-63 

Sequence 8-60 

REDEFINE K display 8-59 

Release disk space (PFREL) . . . 17-89 

RELEASE DSD command 5-70 

Releasing disk space 12-8 
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Remote batch facility (see RBF) . 3-136 
Remote diagnostic facility (see RDF)3-36, 

3-137 

Remote host facility (see RHF) . . 3-137 
Removable device 

Assignment 3-51 

Assignment entry 3-86 

Removable mass storage device . . . 3-51 
Removable mass storage devices . 3-151 
REMOVABLE PACKS IPRDECK entry 

3-151 

REMOVE EQPDECK entry .... 3-86 

REPEAT DSD command 5-37 

Report unsolicited status command 15-50 

REPRINT DSD command 5-38 

REPUNCH DSD command 5-38 

RERUN DSD command 5-7 

Reset device attributes 3-102 

RESET EQPDECK entry . . 3-102,2-7 
RESIDENT RDF IPRDECK entry 3-151 

RETRY DSD command 5-38 

REWIND DSDI directive 6-10 

RHF 

Applications 8-73 

Commands 8-76 

Configuration file directives . . 10-20 

Configuration files 10-8 

Initiation 8-74 

IPRDECK entry 3-137 

K display 8-73 

Operator interface 8-74 

Termination 8-81 

RHF DSDI directive 6-42 

RHFffff DSD command 5-54 

RNS DIS command 4-16 

ROLLIN DSD command 5-7 

ROLLOUT DIS command 4-16 

ROLLOUT DSD command 5-7 

RPL DSDI directive 6-37 

RSS DIS command 4-16 

S 

SAB DSDI directive 6-37 

SC DSDI directive 6-47 

SCHEDULE DSD command .... 5-65 

Scheduling jobs 3-108 

SCKP EQPDECK entry 3-85 



SCOPE 2 station facility (see SSF) 3-37, 

3-137, C-l 

SCP IPRDECK entry 3-128 

SCRATCH DSD command 5-39 

Screen management facility (see SMF) 

3-137 

SCRSIM 

Batch input D-4 

Calling format D-2 

Commands D-5 

Console input D-2 

Description D-l 

IPRDECK entry 3-128 

SCS DIS command 4-16 

SCTD commands 9-9 

SCTDL display 9-9 

SDSPLAY L display 9-11 

Commands 9-16 

System attributes 9-17 

SECCATS IPRDECK entry . . . 3-129 

SECDED DSDI directive 6-37 

Secondary mask 17-7 

Secondary rollout sector threshold 3-158 
SECONDARY USER COMMANDS 

IPRDECK entry 3-151 

Secondary VSN 12-2 

Secured system control commands . 5-70 

SECUREQ DSD command 5-39 

SECURES DSD command 5-70 

SECURES IPRDECK entry . . . 3-152 
Security access categories .... 3-129 
Send message command . . 15-40, 15-51 
Service class 

List 5-10 

Origin type 3-139 

Queue priorities 3-149 

Service limits 3-153 

Table 3-139 

SERVICE DSD command 5-17 

SERVICE IPRDECK entry .... 3-153 

Set access level limits 3-94 

SET DIS command 4-13 

Set disk area flaws 3-105 

Set disk thresholds 3-95 

Set logical flaws 3-105 

Set physical extended memory track 3-105 
SETCPU DSDI directive 6-47 
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SETIOU DSDI directive 6-48 

SETJPS DSDI directive 6-48 

SETRMA DSDI directive 6-49 

SETVEP DSDI directive 6-49 

SFR DSD command 5-75 

SHARE EQPDECK entry 3-87 

Shared device 3-51 

Shared device entry 3-87 

Shared mass storage 

Buffered device 13-7 

Configuring devices .... 13-6, 13-14 

Initialization 13-8, 13-15 

Multimainframe 13-6,13-13 

Recovery tables 13-7 

Unloading 13-9, 13-16 

SKIP DSD command 5-39 

SKIPF DSD command 5-39 

SKIPRU DSD command 5-40 

Slave mode, MSE executive . . . 3-146 

SLF APRDECK entry 3-105 

SMMap 

Problems 11-87 

SM map 

Analysis 11-43 

Backup 11-83 

Description 11-3 

SM/CU linkage statements .... 11-72 

SMF IPRDECK entry 3-137 

SMFffff DSD command 5-54 

SPC IPRDECK entry 3-129 

SPD IPRDECK entry 3-130 

SPF APRDECK entry 3-105 

Spindown 834, 836, 887, and 9853 disk 

units 3-158 

SPINDOWN DSD command .... 5-40 
SPINDOWN IPRDECK entry . . 3-158 

SPINUP DSD command 5-40 

SPL IPRDECK entry 3-130 

Spooled file transfers C-3 

SPW IPRDECK entry 3-130 

SRST DSD command 5-22 

SRST IPRDECK entry 3-158 

SSALTER 

Console input 11-74 

Description 11-74 

SSBLD 
Command 11-70 



Configuration constraints . . . 11-73 

Description 11-70 

Example 11-72 

Statements 11-70 

SSDEBUG 

Command 11-59 

Description 11-59 

Directive parameter 11-61 

Directives 11-60 

Restrictions 11-65 

Usage 11-64 

SSDEF command 11-13 

SSEXEC 

Description 11-12 

Master mode 3-30 

SSF 

Coupler 3-37 

Equipment configuration C-l 

Error logout C-3 

File transfers C-l 

IPRDECK entry 3-137 

SSF K display 8-82 

File transfer commands 8-84 

File transfers 8-82 

Operator interface 8-82 

Spooled file commands 8-85 

Staged file commands 8-84 

Station disconnection 8-83 

Station login 8-82 

Station logout 8-83 

Station recovery 8-83 

SSLABEL 

Command 11-14, 11-15 

Description 11-14 

Directive parameters 11-19 

Directives 11-15 

Example 11-23 

Restrictions 11-23 

Update sequence 11-22 

SSMOVE 

Command 11-25 

Description 11-24 

Directives 11-27 

Example 11-36 

Restrictions 11-35 

Selection algorithms 11-32 
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Specific file directives 11-27 

Value specifier directives . . . 11-28 

SST DSDI directive 6-38 

SSUSE 

Basic usage report 11-52 

Command 11-51 

Description 11-51 

Optional report A 11-54 

Optional report B 11-56 

Optional report C 11-57 

Optional report D 11-58 

SSVAL 

Command 11-40 

Description 11-40 

Error classification 11-43 

Error detection 11-43 

Examples 11-49 

Problem fixing 11-46 

Problem reporting 11-43 

Release processing . . . 11-42, 11-46 

Restrictions 11-50 

Typical runs 11-49 

Validation report 11-47 

Staged file transfers C-2 

Staging 12-2 

Staging files 17-3 

Status host element command . . 15-18 
Status message formats 

DOP 15-43 

HOP 15-9 

NOP 15-23 

Status network element command 15-52 
Status/control register simulation . 3-128 
Status/control register simulator (see 

SCRSIM) D-l 

STEP DSD command 5-65 

STIMULA 3-31 

Stimulator equipment EST entry . . 3-31 

STMIPRDECK entry 3-137 

STMfflf DSD command 5-54 

STOP DSD command .... 5-40, 5-54 
Storage media defects 

APRDECK entries 1-5 

EQPDECK entries 1-5 

Example 1-6 

FLAW utility 1-4 

Flawed disk space 1-3 



FORMAT utility 1-5 

Keeping records 1-3 

Known defects 1-3 

Management 1-1 

Reinitializing 1-7 

Releasing files 1-7 

Tools 1-4 

STORNET 

EST entry 3-66 

External memory 3-55 

Subcontrol point processing . . - 3-131 

SUBCP IPRDECK entry 3-131 

Subfamily 11-12 

SUBSYST L display 9-19 

Subsystem control commands . . . 5-50 

SUI DIS command 4-16 

Summary file 17-29 

SUPPRESS DSD command .... 5-41 
SYSEDIT 

Descrption 19-1 

Directives 19-3 

Record types 19-10 

SYSEDIT command 19-1 

SYSEDIT directives 

*/ 19-8 

*AD 19-5 

*CM 19-3 

*DELETE 19-8 

*FILE 19-9 

*FL 19-7 

"IGNORE 19-9 

*MS 19-4 

*PPSYN 19-9 

*SC 19-7 

System 

Access level limits 3-152 

Checkpoint entry 3-85 

Console lock 3-145 

Console unlock 3-160 

Control commands 5-56 

Control point facility 3-128 

Debug mode 3-159 

Delay parameters 3-141 

Device 3-51 

File initialization 20-1 

Library 3-84 
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Library device entry 3-84 

Tape density 3-132 

System dayfile 3-16 

SYSTEM DEBUG IPRDECK entry 3-159 
SYSTEM EQPDECK entry 3-84 

T 

T DIS command 4-16 

TAF IPRDECK entry 3-137 

TAF K display 

Commands 8-92 

CRMTASK commands 8-96 

Initialization 8-86 

Restarting 8-90 

Status 8-90 

TAFfflff DSD command 5-55 

Tape 

Conversion mode 3-131 

Density 3-132 

Device type 3-132 

Track type 3-132 

Tape alternate storage 12-1 

Tape management system (TMS) . 3-133 
TAPE PF STAGING IPRDECK entry 3-160 

TBDUMP DSDI directive 6-38 

TCVM IPRDECK entry 3-131 

TDEN IPRDECK entry 3-132 

TDTY IPRDECK entry 3-132 

TEMP DSD command 5-41 

Temporary file device 3-51 

TERMINATE DSD command .... 5-41 
THRESHOLD DSD command . . . 5-42 
THRESHOLD EQPDECK entry . . 3-95 

TIME DSD command 5-66 

TMS IPRDECK entry 3-133 

TMSTO IPRDECK entry .... 3-133 

Toggle autoloading 3-96 

TRACE DSD command 5-84 

TRACE IPRDECK entry 3-134 

TRACEBK DSDI directive 6-50 

TRACER commands 

ACPD 21-4 

CPD 21-3 

ENDCPD 21-5 

ICPD 21-6 

TRACER utility 

Commands 21-4 



Conditions monitored 21-1 

Data items reported 21-18 

Description 21-1 

Example 21-8 

Fast loop items 21-18,21-21 

Medium loop items . . . 21-19,21-27 

Output file format 21-7 

Programs 21-3 

Slow loop items 21-20, 21-31 

Statistical summary 21-33 

Summary file format 21-17 

Track reservation table (TRT) . . 17-23 

TRAIN DSD command 5-43 

Transaction facility (see TAF) . . 3-137 

TRAP DSD command 5-87 

TST command 15-47 

Two-port multiplexer EST entry . . 3-36 

u 

U DIS command 4-17 

UCC DIS command 4-17 

UEC DSDI directive 6-13 

UEM equipment initialization . . . 3-93 

UEMIN EQPDECK entry 3-93 

Unified extended memory 3-56 

Unit record equipment EST entry . . 3-23 

UNLOAD DSD command 5-45 

UNLOCK DSD command . . 5-67, 5-71 
UNLOCK IPRDECK entry .... 3-160 
Unsolicited status reports 

DOP 15-45 

HOP 15-10 

NOP 15-25 

UNSTEP DSD command 5-68 

UP channel entry 3-79 

UP DSD command 5-47 

UP EQPDECK entry 3-79 

User extended memory 3-160 

USER EXTENDED MEMORY IPRDECK 

entry 3-160 

User index 17-4 

Utilities 

Controlware loading 1-1 

Dayfile dumping 18-55 

Deadstart dump interpreter . . . 6-1 
Display disk file J-l 
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GENPFD 12-11 

K-display 8-1 

L display 9-1 

MHF 14-2 

MSE 11-1 

NAD maintenance 14-1 

NETOU 15-1 

Network 16-1 

Permanent file 17-1 

PROBE 21-36 

Queued file 18-1 

RCFGEN 10-8 

Tracer 21-1 

V 

VDIS command 4-17 

V DSD command 5-77 

VALIDATE DSD command .... 5-47 

VE CMRDECK entry 3-11 

VERSION CMRDECK entry .... 3-12 

Volume 11-12 

VSN 

Primary 12-1 



Secondary 12-2 

VSN DSD command 5-47 

w 

W DSDI directive 6-16 

WARN DSD command 5-8 

Workstation commands 22-13 

X 

XDIS command 4-17 

X DSD command 5-68 

X.AFD DSD command 5-3 

X.DFD DSD command 5-3 

X.ELD DSD command 5-3 

X.FLAW command 8-4 

XMDD DSD command 5-68 

X.MREC command 8-17 

XQMOVE DSD command 5-4 

XQREC DSD command 5-4 

XM EQPDECK entry 3-92 

XP DSDI directive 6-50 
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